API 接入文档

export TOKENBOX_API_KEY="tfk-your-key"

curl https://tokenbox.me/v1/models \
  -H "Authorization: Bearer $TOKENBOX_API_KEY"

curl -N https://tokenbox.me/v1/chat/completions \
  -H "Authorization: Bearer $TOKENBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<TEXT_MODEL_ID>",
    "messages": [
      {"role": "user", "content": "用一句话介绍杭州"}
    ],
    "stream": true,
    "stream_options": {"include_usage": true}
  }'

curl https://tokenbox.me/v1/asset-groups \
  -H "Authorization: Bearer $TOKENBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "brand-kit"}'

# 1. Register the asset and receive a presigned upload grant
curl https://tokenbox.me/v1/assets \
  -H "Authorization: Bearer $TOKENBOX_API_KEY" \
  -H "Idempotency-Key: asset-import-20260913-001" \
  -H "Content-Type: application/json" \
  -d '{
    "group_id": "vag_xxxxxxxxxxxx",
    "name": "hero.jpg",
    "type": "image",
    "content_type": "image/jpeg",
    "size_bytes": 184320
  }'
# response: { "asset": { "id": "vas_...", "status": "uploading" },
#             "upload": { "method": "PUT", "url": "https://...", "headers": {...} } }

# 2. Upload the bytes straight to object storage using the grant
curl -X PUT "<upload.url>" \
  -H "Content-Type: image/jpeg" \
  --data-binary @hero.jpg

# 3. Finalize; the platform verifies size + content and relays to the provider
curl https://tokenbox.me/v1/assets/vas_xxxxxxxxxxxxxxxx/complete \
  -X POST -H "Authorization: Bearer $TOKENBOX_API_KEY"

# Poll until status becomes "active", then reference it in video generation
curl "https://tokenbox.me/v1/assets?group_id=vag_xxxxxxxxxxxx&status=active" \
  -H "Authorization: Bearer $TOKENBOX_API_KEY"

# 1. List failed assets. Each item includes error_code, error_message, and retryable.
curl "https://tokenbox.me/v1/assets?status=failed&limit=100&offset=0" \
  -H "Authorization: Bearer $TOKENBOX_API_KEY"

# 2. Retry one retryable asset
curl -X POST https://tokenbox.me/v1/assets/vas_xxxxxxxxxxxxxxxx/retry \
  -H "Authorization: Bearer $TOKENBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# 3. Retry up to 100 failed assets in one request
curl -X POST https://tokenbox.me/v1/assets/retry \
  -H "Authorization: Bearer $TOKENBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_ids":["vas_xxxxxxxxxxxxxxxx","vas_yyyyyyyyyyyyyyyy"]}'

# response: {
#   "requested": 2,
#   "requeued": [{"id":"vas_xxxxxxxxxxxxxxxx","status":"registering"}],
#   "skipped": [{"asset_id":"vas_yyyyyyyyyyyyyyyy","code":"not_retryable"}]
# }

# 1. Create one durable ZIP import task
curl https://tokenbox.me/v1/asset-imports \
  -H "Authorization: Bearer $TOKENBOX_API_KEY" \
  -H "Idempotency-Key: zip-import-20260913-001" \
  -H "Content-Type: application/json" \
  -d '{"group_id":"vag_xxxxxxxxxxxx","name":"brand-assets.zip","size_bytes":52428800}'

# 2. Request a fresh grant for each missing part, then PUT that part
curl -X POST https://tokenbox.me/v1/asset-imports/vai_xxxxxxxxxxxxxxxx/parts/1 \
  -H "Authorization: Bearer $TOKENBOX_API_KEY"
curl -X PUT "<part.url>" --data-binary @part-0001

# 3. Resume by listing server-confirmed parts; upload only missing numbers
curl https://tokenbox.me/v1/asset-imports/vai_xxxxxxxxxxxxxxxx/upload \
  -H "Authorization: Bearer $TOKENBOX_API_KEY"

# 4. Merge all parts and queue background validation and provider registration
curl https://tokenbox.me/v1/asset-imports/vai_xxxxxxxxxxxxxxxx/complete \
  -X POST -H "Authorization: Bearer $TOKENBOX_API_KEY"

# 5. Poll the durable task; the browser may be closed after step 4
curl https://tokenbox.me/v1/asset-imports/vai_xxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer $TOKENBOX_API_KEY"

export IDEMPOTENCY_KEY="$(uuidgen)"

curl https://tokenbox.me/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $TOKENBOX_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.5",
    "content": [
      {"type": "text", "text": "参考 @图像1、@视频1 和 @音频1 的主体、运动与节奏，生成一段连贯视频"},
      {"type": "image_url", "role": "reference_image",
       "image_url": {"url": "asset://vas_xxxxxxxxxxxxxxxx"}},
      {"type": "video_url", "role": "reference_video",
       "video_url": {"url": "asset://vas_yyyyyyyyyyyyyyyy"}},
      {"type": "audio_url", "role": "reference_audio",
       "audio_url": {"url": "asset://vas_zzzzzzzzzzzzzzzz"}}
    ],
    "resolution": "720p",
    "ratio": "adaptive",
    "duration": -1,
    "omni_reference_task_type": "auto"
  }'