Coze (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.

import requests

response = requests.post(
    "https://api.coze.cn/v3/chat",
    headers={
        "Authorization": "Bearer your-coze-token",
        "Content-Type": "application/json"
    },
    json={
        "bot_id": "your-bot-id",
        "user_id": "user123",
        "stream": False,
        "messages": [{"role": "user", "content": "你好！"}]
    }
)
print(response.json())

cURL smoke test

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

curl https://api.provider.example/v1/chat/completions \
  -H "Authorization: Bearer $COZE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "多模型可选",
    "messages": [{"role": "user", "content": "Hello from yangmao.ai"}]
  }'

Decision checklist

Related internal links

FAQ