开发者文档

TokenHub 接入文档

示例使用当前品牌的 Base URL。请用你自己的 API Key 替换占位符。

Base URL · localhost

可用模型：tokenhub/echo-1、bytedance/seedance-1.0、tokenhub/image-demo、google/gemini-flash、z-ai/glm-5.3-flash、bailian/qwen3.8-flash、deepseek/deepseek-v4-flash-vision-exp、bailian/qwen3.8-27b、z-ai/glm-5.3、deepseek/deepseek-v4-pro-0813、google/gemini-3.7-flash、x-ai/grok-4.6、bytedance/seedance-2.5、bailian/qwen-image-3.0、bailian/qwen-image-3.0-pro、bailian/qwen3.8-max、deepseek/deepseek-v4-flash-0731、openai/gpt-transcribe、anthropic/claude-opus-5、google/gemini-3.5-flash-lite、google/gemini-3.6-flash、moonshotai/kimi-k3、openai/gpt-5.6-luna、openai/gpt-5.6-sol、openai/gpt-5.6-terra、volcengine/doubao-seed-character、volcengine/doubao-seedream-5.0-pro、x-ai/grok-4.5、anthropic/claude-sonnet-5、google/gemini-3.1-flash-lite-image、alibaba/happyhorse-1.0、alibaba/happyhorse-1.1、volcengine/doubao-seed-2.1-pro、volcengine/doubao-seed-2.1-turbo、volcengine/doubao-seed-evolving、microsoft/mai-image-2.5-pro、google/gemini-3-pro-image、google/gemini-3.1-flash-image、z-ai/glm-5.2、bytedance/seedance-2.0-mini、moonshotai/kimi-k2.7-code、moonshotai/kimi-k2.7-code-highspeed、anthropic/claude-fable-5、microsoft/mai-image-2.5、microsoft/mai-image-2.5-flash、bailian/qwen3.7-plus、minimax/minimax-m3、anthropic/claude-opus-4.8、bailian/qwen3.7-max、google/gemini-3.5-flash、google/gemini-3.1-flash-lite、x-ai/grok-4.3、openai/gpt-5.5、deepseek/deepseek-v4-flash-0423、deepseek/deepseek-v4-pro-0423、bailian/qwen3.6-27b、moonshotai/kimi-k2.6、openai/gpt-image-2、bailian/qwen3.6-max-preview、anthropic/claude-opus-4.7、bailian/qwen3.6-flash、alibaba/wan-2.7、bytedance/seedance-2.0、bytedance/seedance-2.0-fast、bailian/qwen3.6-plus、z-ai/glm-5v-turbo、x-ai/grok-4.20、alibaba/wan-2.6、z-ai/glm-5.1、minimax/minimax-m2.7、minimax/minimax-m2.7-highspeed、openai/gpt-5.4-mini、openai/gpt-5.4-nano、openai/gpt-5.1-codex-mini、z-ai/glm-5-turbo、openai/gpt-5.4、openai/gpt-5.4-pro、openai/gpt-5.3-codex、bailian/qwen3.5-122b-a10b、bailian/qwen3.5-27b、bailian/qwen3.5-35b-a3b、volcengine/doubao-seed-2.0-mini、bailian/qwen3.5-397b-a17b、bailian/qwen3.5-flash、bailian/qwen3-coder-next、google/gemini-3.1-pro-preview、anthropic/claude-sonnet-4.6、bailian/qwen3.5-plus、volcengine/doubao-seed-2.0-code、volcengine/doubao-seed-2.0-lite、volcengine/doubao-seed-2.0-pro、minimax/minimax-m2.5、minimax/minimax-m2.5-lightning、z-ai/glm-5、anthropic/claude-opus-4.6、volcengine/doubao-seedream-5.0-lite、openai/gpt-5.1、moonshotai/kimi-k2.5、bailian/qwen3-max、minimax/m2-her、z-ai/glm-4.7-flashx、openai/gpt-5.2-codex、volcengine/doubao-seed-1-8、minimax/minimax-m2.1、minimax/minimax-m2.1-lightning、z-ai/glm-4.7、google/gemini-3-flash-preview、openai/gpt-image-1.5、openai/gpt-4o-mini-transcribe、openai/gpt-5.2、openai/gpt-5.1-codex-max、bailian/qwen-plus、deepseek/deepseek-v3.2、volcengine/doubao-seedream-4.5、x-ai/grok-4.1-fast、openai/text-embedding-3-large、openai/text-embedding-3-small、minimax/minimax-m2、anthropic/claude-haiku-4.5、openai/gpt-4o-transcribe-diarize、volcengine/doubao-seed-1-6、google/gemini-2.5-flash-image、z-ai/glm-4.6、bailian/qwen3-coder-plus、volcengine/doubao-seed-1-6-flash、volcengine/doubao-seed-1-6-vision、bailian/qwen-vl-max、openai/gpt-5、openai/gpt-5-mini、openai/gpt-5-nano、bailian/qwen3-coder-flash、bailian/qwen-flash、google/gemini-2.5-flash-lite、bailian/qwen-turbo、google/gemini-2.5-flash、google/gemini-2.5-pro、openai/gpt-4.1、openai/gpt-4.1-mini、bailian/qwen-max、bailian/text-embedding-v4、openai/gpt-4o-mini、openai/gpt-4o

curl

curl -sS https://localhost/v1/chat/completions -H 'Authorization: Bearer $TOKENHUB_API_KEY' -H 'Content-Type: application/json' -d '{"model":"tokenhub/echo-1","messages":[{"role":"user","content":"hi"}]}'

Python

from openai import OpenAI
client = OpenAI(base_url='https://localhost/v1', api_key='...')
print(client.chat.completions.create(model='tokenhub/echo-1', messages=[{'role':'user','content':'hi'}]))

Node.js

const OpenAI = require('openai')
const client = new OpenAI({ baseURL: 'https://localhost/v1', apiKey: process.env.TOKENHUB_API_KEY })
await client.chat.completions.create({ model: 'tokenhub/echo-1', messages: [{ role: 'user', content: 'hi' }] })

Anthropic Messages

curl -sS https://localhost/v1/messages -H 'Authorization: Bearer $TOKENHUB_API_KEY' -H 'Content-Type: application/json' -d '{"model":"tokenhub/echo-1","max_tokens":32,"messages":[{"role":"user","content":"hi"}]}'

视频任务

curl -sS https://localhost/v1/videos -H 'Authorization: Bearer $TOKENHUB_API_KEY' -H 'Content-Type: application/json' -d '{"model":"tokenhub/video-demo","prompt":"a river at dusk"}'

错误体为 {error:{code,message,request_id}}。常见 code：invalid_request、authentication_error、rate_limited、insufficient_balance。

超过 API Key RPM/并发返回 429 rate_limited。

媒体回调 POST /v1/media/callbacks，校验 X-Tokenhub-Signature；支付回调按适配器验签，均按 event_id 幂等。