API 文档
WorldAPI 与 OpenAI 接口兼容:任意 OpenAI SDK 只需更换 base URL 并填入 WorldAPI 密钥即可使用。
Base URL
https://worldapi.cc/v1快速开始
在控制台创建 API 密钥,导出为环境变量 WORLDAPI_KEY,然后发送一次对话请求。 创建密钥
curl
curl https://worldapi.cc/v1/chat/completions \
-H "Authorization: Bearer $WORLDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.8-flash",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Write a haiku about the sea."}
],
"stream": true
}'Python · openai ≥ 1.0
from openai import OpenAI
client = OpenAI(
base_url="https://worldapi.cc/v1",
api_key="wapi-sk-...",
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Summarize this in one line: ..."}],
)
print(resp.choices[0].message.content)
print(resp.usage) # prompt_tokens, completion_tokens, total_tokensTypeScript · openai
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://worldapi.cc/v1",
apiKey: process.env.WORLDAPI_KEY,
});
const stream = await client.chat.completions.create({
model: "gemini-3.5-flash-lite",
messages: [{ role: "user", content: "Hello!" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}身份验证
在 Authorization 请求头中以 Bearer 方式携带密钥(也支持 x-api-key)。密钥以 wapi-sk- 开头,仅在创建时展示一次;可随时在控制台吊销并重新创建。
Authorization: Bearer wapi-sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
模型
将价目表中的公开 id 作为 model 参数传入。GET /v1/models 返回带价格的相同列表。 查看完整价目表
GET https://worldapi.cc/v1/models
gpt-4.1gpt-4.1-minigpt-4.1-nanogpt-4ogpt-4o-minigpt-5gpt-5-minigpt-5-nanogpt-5.1gpt-5.1-codexgpt-5.2gpt-5.2-codexgpt-5.3-codexgpt-5.4gpt-5.4-minigpt-5.4-nanogpt-5.5gpt-5.6-lunagpt-5.6-solgpt-5.6-terragpt-oss-120bgpt-oss-20bclaude-3-haikuclaude-fable-5claude-fable-5.1claude-haiku-4.5claude-opus-4.1claude-opus-4.5claude-opus-4.6claude-opus-4.7claude-opus-4.8claude-opus-5claude-sonnet-4claude-sonnet-4.5claude-sonnet-4.6claude-sonnet-5gemini-2.5-flashgemini-2.5-flash-litegemini-3.1-flash-litegemini-3.1-progemini-3.5-flashgemini-3.5-flash-litegemini-3.6-flashgemini-3.7-flashgemini-3.8-flashgemma-4-26bdeepseek-v4-flashqwen3-235bqwen3-coderqwen3-next-80bqwen3-next-80b-thinkingglm-4.7glm-5kimi-k2-thinkingkimi-k2.5llama-3.1-70bminimax-m2grok-4.6nova-2-litenova-litenova-micronova-propalmyra-x5计费与用量
用量以套餐形式购买后使用。每次请求按 token 计价并从剩余用量中扣除;剩余用量为 0 时请求将以 402 拒绝。
每个模型分别标注官方价与折扣价,具体见价目表。
响应返回标准 OpenAI 格式的 usage 对象(流式在最后一个分块)。每次请求的费用可在控制台查看。
usage
"usage": {
"prompt_tokens": 120,
"completion_tokens": 48,
"total_tokens": 168
}错误
错误采用 OpenAI 格式:{ error: { message, type, code } }。失败的请求不计费。
| HTTP | code | 含义 |
|---|---|---|
| 401 | invalid_api_key | 密钥缺失、格式错误或已吊销。 |
| 402 | insufficient_balance | 剩余用量为 0,请在控制台购买用量套餐。 |
| 404 | model_not_found | 未知的模型 id。 |
| 429 | rate_limit_error | 上游厂商限流,请退避后重试。 |
| 502 / 504 | upstream_error | 上游厂商故障或超时。不计费,可重试。 |
402
{
"error": {
"message": "No remaining usage on this account. Buy a usage pack at https://worldapi.cc/dashboard/billing.",
"type": "insufficient_quota",
"code": "insufficient_balance"
}
}限制
- 请求体最大 6 MB;流式响应最长 5 分钟。
- 每个账户最多 20 个有效密钥。
- 账户级限流与我们持有的云端配额一致;如需预留吞吐量请联系客服。