Doubao (ByteDance) Free API Guide

Provider fit matrix

Production readiness checklist

Python setup snapshot

Start with the smallest possible chat completion, then move the key to your server-side secret manager before production.

from openai import OpenAI

client = OpenAI(
    api_key="your-doubao-key",
    base_url="https://ark.cn-beijing.volces.com/api/v3"
)

# Seed 2.0 Mini — 极速低价
response = client.chat.completions.create(
    model="doubao-seed-2-0-mini-260215",
    messages=[{"role": "user", "content": "你好！"}],
)
print(response.choices[0].message.content)

cURL smoke test

Use this to verify endpoint, auth header, model name, response shape, and quota before adding SDK abstractions.

curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \
  -H "Authorization: Bearer $DOUBAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seed 2.0 Pro",
    "messages": [{"role": "user", "content": "Hello from yangmao.ai"}]
  }'

Decision checklist

Related internal links

FAQ