言言火API
接入文档
API 服务返回控制台
QUICK START

言火API 接入指南

言火API 为 OpenAI、Claude Code、Codex 等客户端提供统一鉴权、模型路由、人民币余额计费和调用日志。接入时只需要替换 Base URL、API Key 和模型名称。

当前 API 地址
统一密钥使用同一类 sk-relay 密钥调用不同模型
兼容接口支持 Chat Completions、Responses 与 Messages
透明计费响应返回本次扣费和剩余余额

1. 获取 API Key

  1. 登录言火API控制台。
  2. 进入“API 密钥”，点击“新建密钥”。
  3. 设置名称、额度、RPM 和允许模型。
  4. 立即复制完整密钥，关闭窗口后无法再次查看。
密钥格式sk-relay-...请勿使用上游供应商密钥调用中转站。

2. Base URL 与端点

所有客户端统一填写站点根地址，客户端会自动拼接各自路径。OpenAI 兼容客户端也继续兼容带 /v1 的写法。

客户端Base URL实际端点
OpenAI SDK/chat/completions（兼容 /v1/chat/completions）
Claude Code/v1/messages
Codex/responses
模型名称必须使用“模型与价格”页面展示的公开模型名，不能随意填写上游模型名。

3. OpenAI Python SDK

适合大多数 Python 项目。先安装 SDK：

PowerShell
pip install openai
Python
from openai import OpenAI

client = OpenAI(
    api_key="sk-relay-你的密钥",
    base_url="__OPENAI_BASE__"
)

response = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
)

print(response.choices[0].message.content)

4. Python Requests

Python
import requests

response = requests.post(
    "__BASE__/chat/completions",
    headers={
        "Authorization": "Bearer sk-relay-你的密钥",
        "Content-Type": "application/json",
    },
    json={
        "model": "deepseek-flash",
        "messages": [{"role": "user", "content": "你好"}],
        "max_tokens": 1000,
    },
    timeout=120,
)

response.raise_for_status()
data = response.json()
print(data["choices"][0]["message"]["content"])
print("本次费用：", data.get("billing"))

5. Claude Code

Claude Code 使用 Anthropic Messages 协议。Base URL 统一填写站点根地址，不要手动添加 /v1。

Windows PowerShell
$env:ANTHROPIC_BASE_URL="__BASE__"
$env:ANTHROPIC_AUTH_TOKEN="sk-relay-你的密钥"
$env:ANTHROPIC_MODEL="deepseek-flash"

claude
Linux / macOS
export ANTHROPIC_BASE_URL="__BASE__"
export ANTHROPIC_AUTH_TOKEN="sk-relay-你的密钥"
export ANTHROPIC_MODEL="deepseek-flash"

claude
即使使用 Claude Code，DeepSeek 官方上游渠道仍应配置为“OpenAI 兼容”。协议转换由言火API自动完成。

6. Codex

编辑 ~/.codex/config.toml，使用 Responses API：

TOML
model_provider = "relay"
model = "gpt-5.6-sol"

[model_providers.relay]
name = "言火API"
base_url = "__BASE__"
wire_api = "responses"
requires_openai_auth = false
env_key = "LIGHTRELAY_API_KEY"
PowerShell
$env:LIGHTRELAY_API_KEY="sk-relay-你的密钥"
codex

修改环境变量后，需要在同一个终端窗口中重新启动 Codex。

7. cURL

Shell
curl "__BASE__/chat/completions" \
  -H "Authorization: Bearer sk-relay-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

8. 获取可用模型

调用模型列表接口可以获得当前已启用的公开模型名称。

Shell
curl "__BASE__/models" \
  -H "Authorization: Bearer sk-relay-你的密钥"

9. 流式响应

Chat Completions、Claude Messages 和 Codex Responses 均支持流式输出。OpenAI SDK 示例：

Python
stream = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "写一段短文"}],
    stream=True,
)

for chunk in stream:
    text = chunk.choices[0].delta.content
    if text:
        print(text, end="", flush=True)

10. 计费规则

模型按照后台配置的人民币每百万 Token 售价计费，可分别配置输入、输出、缓存创建和缓存读取价格。

本次费用 = 输入 Token × 输入售价 + 输出 Token × 输出售价 + 缓存 Token 对应费用

非流式响应会附带：

JSON
{
  "billing": {
    "currency": "CNY",
    "amount_cny": 0.0123,
    "balance_cny": 9.9877
  }
}

实际扣费、Token 数和请求状态可在控制台“调用日志”中查看。

11. 常见错误

401缺少或无效的 API Key确认使用中转站生成的 sk-relay 密钥，并通过 Bearer 或客户端指定的认证变量发送。
402余额不足或密钥额度用完充值账户余额，或提高 API Key 的独立额度。
404模型不存在或未启用从“模型与价格”复制准确的公开模型名。
405请求路径错误所有客户端都使用站点根地址作为 Base URL；OpenAI 兼容客户端也兼容带 /v1 的地址。
429请求过于频繁降低并发，或提高密钥 RPM。
502上游调用失败管理员检查渠道密钥、代理、模型白名单和最近错误。
503没有可用渠道模型的供应商和协议必须与至少一个已启用渠道一致。

12. 安全建议

  • 不要把 API Key 提交到 Git、前端代码或公开聊天。
  • 为生产、测试、Claude、Codex 分别创建独立密钥。
  • 设置合理的额度和 RPM，降低泄露后的损失。
  • 发现密钥泄露后立即删除，并创建新密钥。
  • 公网部署必须启用 HTTPS，并更换默认管理员密码。
准备开始了吗？创建 API Key 并完成第一次调用
进入控制台 →
已复制