Nội dungBắt đầu nhanh
开发者文档 · API V1

ThAPI 集成文档

连接应用、发送首个请求或查阅协议。集成前请核对当前模型和价格。

快速上手

安装示例所需库并使用受支持的运行时，在环境中设置 STALI_API_KEY。将示例模型替换为当前可用且匹配协议的模型。

SDK 设置与 API 密钥检查

安装所用语言对应的库。在 Bash 或 PowerShell 中以隐藏输入方式输入密钥，然后调用 GET /v1/models 检查身份验证并获取模型 ID；此请求不会生成 AI 内容。

read -r -s -p "STALI_API_KEY: " STALI_API_KEY
export STALI_API_KEY
printf '\n'
curl -fsS https://thapi.cloud/v1/models -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}"

cURL 示例适用于 macOS/Linux 上的 Bash 或 WSL/Git Bash。未设置 STALI_API_KEY 时，Python 会提示输入密钥；Node.js 从环境变量读取密钥。

curl -N https://thapi.cloud/v1/messages \
  -H "x-api-key: ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      { "role": "user", "content": "Viết hàm quicksort bằng Python" }
    ]
  }'

内容生成示例会发送真实请求，可能产生费用。运行前请检查计费单位和每次请求的最低费用。

验证 · 查看当前价格

安装 API CLI

需要 Node.js 18 或更高版本。安装 API CLI 后运行 thapi，在向导中输入密钥。使用 api-cli doctor 检查配置；聊天或 ping 请求仍可能收费。

# 推荐用于 Windows、macOS 和 Linux；需要 Node.js >= 18
npm install -g stali-cli@latest

# 备用安装器：npm，失败时回退至 GitHub + Bun：
# curl -fsSL "https://thapi.cloud/install/stali-cli.sh" | bash

# 仅安装，不启动设置向导：
# curl -fsSL "https://thapi.cloud/install/stali-cli.sh" | STALI_CLI_NO_RUN=1 bash

stali
查看完整指南

连接应用

按工具和协议查找指南。

Claude CodeAnthropic

Claude Code：在终端中配置 API 密钥、模型与供应商。

https://thapi.cloud
Codex CLIOpenAI

Codex CLI：在终端中配置 API 密钥、模型与供应商。

https://thapi.cloud/v1
OpenClawAnthropic

OpenClaw：在终端中配置 API 密钥、模型与供应商。

https://thapi.cloud
Hermes AgentAnthropic + OpenAI

Hermes Agent：在终端中配置 API 密钥、模型与供应商。

https://thapi.cloud/v1
← 全部应用

Vòng đời một yêu cầu

Từ API request đến đối soát

Yêu cầu

Gửi endpoint, model và payload theo ví dụ. Giữ API key trong biến môi trường hoặc cấu hình bí mật trên máy chủ.

Chọn từng bước để xem chi tiết. Sơ đồ minh họa luồng xử lý; không hiển thị trạng thái thực tế.

基础 URL

选择适合 SDK 和协议的 URL。

Anthropic https://thapi.cloud

OpenAI https://thapi.cloud/v1

查看完整指南

身份验证

保护密钥并使用正确的请求头。

查看完整指南

端点与协议

按模型能力选择端点。

查看完整指南

图像、音频与视频

检查格式与任务生命周期。

查看完整指南

流式响应

处理事件、用量与最终错误。

查看完整指南

计费

理解 token、按次计费与最低费用。

部分模型设有每次调用最低费用。短请求也可能适用，不能因 token 很少而推断免费。

查看完整指南

错误与重试

通过错误和请求 ID 诊断问题。

如有 x-thapi-request-id，请连同错误时间保存以便排查。报告中不要包含 API 密钥或敏感请求内容。

在价格页面查看模型状态

查看完整指南

限制与超时

了解接入限制与超时。

查看完整指南

生成与编辑图像

了解图像生成、参考图像、结果处理及费用的 JSON 接口。

查看完整指南

视频生成

通过 Videos API 从文字和图片生成视频、查询进度并下载 MP4。

查看完整指南

读取图像

检查格式与任务生命周期。

查看完整指南

响应头

如有 x-thapi-request-id，请连同错误时间保存以便排查。报告中不要包含 API 密钥或敏感请求内容。

查看完整指南

故障排除

遵守 Retry-After，使用带随机抖动的指数退避，并限制次数与总时长。视频任务可能已创建时，先查询任务 ID，避免重复提交。

查看完整指南

示例经过源码审查和本地检查，不代表已验证每个应用版本。正式使用前请检查设置、发送小型请求并确认用量。

Nhóm Zalo