How to hit the Doubao (Volcano Engine Ark / BytePlus ModelArk) API

ByteDance serves its Doubao and Seed models through Ark: BytePlus ModelArk internationally at https://ark.ap-southeast.bytepluses.com/api/v3, and Volcano Engine Ark in China at https://ark.cn-beijing.volces.com/api/v3. Both are OpenAI-compatible.

Authentication

Create an API key in the ModelArk (or Volcano Engine Ark) console and send it as Authorization: Bearer <key>. In the examples it's written {{ARK_API_KEY}}. model is a model id or an endpoint id you've created in the console.

Full reference: https://docs.byteplus.com/en/docs/ModelArk

Chat (BytePlus ModelArk)

curl https://ark.ap-southeast.bytepluses.com/api/v3/chat/completions \
  -H "Authorization: Bearer {{ARK_API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{"model": "seed-2-0-lite-260228", "messages": [{"role": "user", "content": "Hello!"}]}'
Run in PostTaco

Chat (Volcano Engine Ark, China)

Use a Doubao model id or your endpoint id from the Volcano Engine console.

curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \
  -H "Authorization: Bearer {{ARK_API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{"model": "{{MODEL_OR_ENDPOINT_ID}}", "messages": [{"role": "user", "content": "你好!"}]}'
Run in PostTaco