API

兼容 OpenAI。涵盖所有模型。

将你现有的 OpenAI SDK 指向 https://api.yout.chat/v1 并使用你的 Yout.chat 密钥,即可调用所有主流模型。一个积分池、一张账单,无需逐模型签约。

Base URL: https://api.yout.chat/v1 · 认证: Authorization: Bearer <your-key>

即插即用替换

如果你的代码已经在调用 OpenAI API,你只需改动两处。

from openai import OpenAI

client = OpenAI(
    api_key="yout-...",                  # ← from Account → API keys
    base_url="https://api.yout.chat/v1",       # ← that's it
)

resp = client.chat.completions.create(
    model="anthropic-claude-sonnet-46",
    messages=[
        {"role": "user", "content": "Write a haiku about caching."},
    ],
)
print(resp.choices[0].message.content)

可无缝配合 OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, 以及任何使用 OpenAI 格式的工具。

端点

所有端点都接受 Authorization: Bearer <key>. 网页应用可使用会话 Cookie。

POST/v1/chat/completions

兼容 OpenAI。 传入 stream: true 以启用 SSE。积分按原子方式扣除。

请求体
{
  "model": "anthropic-claude-sonnet-46",
  "messages": [
    {"role": "system", "content": "You are helpful."},
    {"role": "user",   "content": "What is 2+2?"}
  ],
  "stream": false,
  "temperature": 0.7,
  "max_tokens": 512
}
响应(非流式)
{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "anthropic-claude-sonnet-46",
  "choices": [{"index":0,"message":{"role":"assistant","content":"Four."},"finish_reason":"stop"}],
  "usage": {"prompt_tokens": 15, "completion_tokens": 2, "total_tokens": 17},
  "yout": {"credits_charged": 10, "balance": 14999990}
}
GET/v1/models

兼容 OpenAI 的模型列表。包含每个活跃模型的 id, context_window, 以及每 token 的积分成本。

POST/api/chat/stream/

原生流式端点——JSON 结构比 OpenAI 的更简单,由网页应用使用。为兼容第三方 SDK,建议优先使用 /v1/chat/completions

GET/api/chat/models/

更丰富的模型目录,含任务标签、模态、仅限 Pro 标志。可用于你自己的界面。

GET/api/chat/limit/

你当前的配额——积分余额 + 套餐状态,或匿名每日额度。

GET/api/chat/keys/

列出你的活跃 API 密钥(已掩码)。

POST/api/chat/keys/

创建一个命名的 API 密钥。完整 token 仅返回一次——请妥善保存。

请求体
{"name": "production"}
POST/api/chat/keys/<id>/revoke/

撤销密钥。仍在使用它的现有会话将在下一次调用时收到 401

POST/api/media/image/

图像生成任务。返回 job_uuid; 轮询 /api/media/jobs/<uuid>/.

POST/api/media/video/

视频生成任务。5 秒 Veo 约需 120 万积分。失败时自动退还积分。

POST/api/media/speech/

文本转语音。返回 job_uuid; 完成后输出为一个带签名的音频 URL。

GET/api/media/jobs/<uuid>/

轮询生成任务: status, output_url, error, credits_cost.

POST/api/chat/share/

创建一个公开的只读快照。返回一个 /c/<slug> URL。

POST/api/chat/purge/

在服务端清除你的会话、消息和使用记录。

计费

API 用量与网页应用共用同一个积分池。没有独立的 API 计费。

按 token 计价

文本模型收费为 credits_per_1k_input × 输入 token + credits_per_1k_output × 输出 token。媒体模型则按固定的 credits_per_call.

最低收费

每次成功调用至少扣除 10 积分以覆盖开销,与 token 数量无关。

失败退款

在上游失败的图像/视频/语音任务会自动退还积分。文本流失败仅按已产出的内容计费。

透支

当你的余额不足以覆盖预估成本时,调用会返回 402 insufficient_credits 。只要 plan_active 为 true 且余额为正,套餐就不会被限流。

认证与隐私

  • Bearer token — 每个用户一个,可在你的账户页面找到。轮换方式为删除并重新创建账户(规划中将提供专门的轮换端点)。
  • 不转发任何用户标识 — 我们在转发给提供方时不带你的邮箱、IP、用户代理或账户 ID。仅使用通用的 HTTP-Referer: yout.chat
  • no-log 信号 — 会发送给上游,以请求模型提供方在其合同允许的范围内不记录你的提示词、不用于训练。
  • 默认不持久化任何消息内容 — 我们会写入一条 UsageLedger 记录(token + 积分 + 模型),但不包含提示词或响应。

路线图

  • 兼容 OpenAI 的 /v1/chat/completions 适配层,使现有 SDK 无需改动即可运行
  • 为长时间运行的媒体任务提供 Webhook 回调(取代轮询)
  • Token 轮换 + 按 token 的权限范围
  • /stream/ 上使用幂等键 + 重试安全的任务创建
  • 自助式速率限制控制

准备好上线了吗?

免费层为你提供 5 万积分用于试用。需要更多时随时升级。