快速开始
透过与 OpenAI、Anthropic 相容的 API，使用一把金钥呼叫多个模型。本页涵盖验证方式、串流输出、模型选择与错误处理。
兼容 OpenAI SDK · Anthropic SDK · cURL
步骤 1 — 注册并获取免费额度
步骤 2 — 创建 API 密钥
步骤 3 — 设置你的 base URL
https://aaa.ashp.tw/v1
https://aaa.ashp.tw/v1/anthropic
步骤 4 — 发送你的第一个请求
curl https://aaa.ashp.tw/v1/chat/completions \
-H "Authorization: Bearer $AAA_TOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [{"role": "user", "content": "Hello!"}]
}'
请将你自己的 API 密钥（以 sk- 开头）以 Bearer 令牌形式放入 Authorization 请求头。
API 参考
身分验证
每个请求都必须带上你的 API 金钥（以 sk- 开头）。OpenAI 相容端点请使用 Authorization: Bearer 标头；Anthropic 相容端点也可使用 x-api-key 标头。请妥善保管金钥，不要放进前端程式码或公开的程式库。
Authorization: Bearer $AAA_TOKEN_API_KEY
串流输出
在请求中加入 stream: true，即可透过 Server-Sent Events（SSE）逐段接收输出，适合聊天介面与长篇回复。OpenAI 相容的 /v1/chat/completions 与 Anthropic 相容的 /v1/messages 都支援串流。
模型与定价
在请求的 model 栏位填入模型名称即可，例如 claude-sonnet-4-6 或 gpt-5.4。可用模型与各模型的每百万 token 价格请见定价页面。
错误码
| HTTP | 类型 |
|---|---|
401 | API 金钥缺漏、无效或已被停用，请确认金钥是否正确。 |
402 | 帐户余额不足，请储值后再重试。 |
404 | 找不到请求的路径或模型，请检查 Base URL、路径与 model 名称。 |
429 | 请求过于频繁，已触发速率限制。请稍候并以指数退避方式重试。 |
500+ | 上游模型服务发生暂时性错误或逾时，请稍后重试；若持续发生，请联络 [email protected]。 |
影片生成 API（Seedance）
用同一把 API Key 生成 AI 影片。建立任务后会立即回传任务 ID，再以 GET 查询进度，完成时回传影片网址。也相容方舟原生路径 /v1/contents/generations/tasks。
curl https://aaa.ashp.tw/v1/videos/generations \
-H "Authorization: Bearer $AAA_TOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [{"type": "text", "text": "A golden dragon flying over a neon city at night"}],
"resolution": "720p",
"duration": 5,
"ratio": "16:9"
}'
curl https://aaa.ashp.tw/v1/videos/generations/vid_xxxxxxxxxxxxxxxxxxxxxxxx \
-H "Authorization: Bearer $AAA_TOKEN_API_KEY"
计费：影片成功后才扣款，费用 = 影片 token × 模型单价；影片 token ≈ 宽 × 高 × 每秒影格 × 秒数 ÷ 1024。失败或取消的任务不收费。影片网址约 24 小时后失效，请尽快下载。
金钥个别限制
每把 API Key 都能在会员中心单独设定累计与每日花费上限、可用模型、IP 白名单、到期时间与每分钟请求上限，方便安全地把金钥交给团队成员、客户或部署在伺服器上。超过限制时会回传以下错误：
| HTTP | 类型 |
|---|---|
401 | key_expired — 金钥已过期 |
402 | key_spend_limit — 已达这把金钥的累计花费上限 |
403 | model_not_allowed / ip_not_allowed — 模型或来源 IP 不在这把金钥的白名单内 |
429 | key_daily_limit / key_rate_limit — 已达每日花费上限或每分钟请求上限 |
模型清单
GET /v1/models 会回传目前开放的所有模型（OpenAI 格式），Cursor、Cline 等工具可直接读取。
curl https://aaa.ashp.tw/v1/models -H "Authorization: Bearer $AAA_TOKEN_API_KEY"