API Stack 集成文档
连接应用、发送首个请求或查阅协议。集成前请核对当前模型和价格。
Tạo API Key
Lấy khoá bảo mật dạng sk-stk-... từ ví tài khoản để xác thực các request.
Chọn Base URL
Dùng https://apistack.vn cho Anthropic / Claude Code hoặc https://apistack.vn/v1 cho OpenAI SDK.
Chạy thử Request
Sao chép mã cURL hoặc mẫu Python / Node.js bên dưới để nhận phản hồi AI tức thì.
Xem mã mẫu ↓快速上手
安装示例所需库并使用受支持的运行时,在环境中设置 API_KEY。将示例模型替换为当前可用且匹配协议的模型。
SDK 设置与 API 密钥检查
安装所用语言对应的库。在 Bash 或 PowerShell 中以隐藏输入方式输入密钥,然后调用 GET /v1/models 检查身份验证并获取模型 ID;此请求不会生成 AI 内容。
read -r -s -p "API_KEY: " API_KEY
export API_KEY
printf '\n'
curl -fsS https://apistack.vn/v1/models -H "Authorization: Bearer ${API_KEY:?API_KEY}"cURL 示例适用于 macOS/Linux 上的 Bash 或 WSL/Git Bash。未设置 API_KEY 时,Python 会提示输入密钥;Node.js 从环境变量读取密钥。
curl -N https://apistack.vn/v1/messages \
-H "x-api-key: ${API_KEY:?Hãy đặt 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 后运行 API Stack,在向导中输入密钥。使用 API Stack doctor 检查配置;聊天或 ping 请求仍可能收费。
# 推荐用于 Windows、macOS 和 Linux;需要 Node.js >= 18
npm install -g API CLI@latest
# 备用安装器:npm,失败时回退至 GitHub + Bun:
# curl -fsSL "https://apistack.vn/install/api-cli.sh" | bash
# 仅安装,不启动设置向导:
# curl -fsSL "https://apistack.vn/install/api-cli.sh" | API_CLI_NO_RUN=1 bash
API Stack连接应用
按工具和协议查找指南。
Claude Code:在终端中配置 API 密钥、模型与供应商。
Codex CLI:在终端中配置 API 密钥、模型与供应商。
OpenClaw:在终端中配置 API 密钥、模型与供应商。
Hermes Agent:在终端中配置 API 密钥、模型与供应商。
请求生命周期
从 API 请求到费用结算
按照示例发送 endpoint、模型和请求体。将 API key 保存在环境变量或服务端密钥配置中。
选择步骤查看详情。此图仅解释处理流程,不显示实时请求状态。
基础 URL
选择适合 SDK 和协议的 URL。
Anthropic https://apistack.vn
OpenAI https://apistack.vn/v1
身份验证
保护密钥并使用正确的请求头。
查看完整指南端点与协议
按模型能力选择端点。
查看完整指南图像、音频与视频
检查格式与任务生命周期。
查看完整指南流式响应
处理事件、用量与最终错误。
查看完整指南计费
理解 token、按次计费与最低费用。
部分模型设有每次调用最低费用。短请求也可能适用,不能因 token 很少而推断免费。
查看完整指南错误与重试
通过错误和请求 ID 诊断问题。
如有 x-api-request-id,请连同错误时间保存以便排查。报告中不要包含 API 密钥或敏感请求内容。
查看完整指南限制与超时
了解接入限制与超时。
查看完整指南生成与编辑图像
了解图像生成、参考图像、结果处理及费用的 JSON 接口。
查看完整指南视频生成
通过 Videos API 从文字和图片生成视频、查询进度并下载 MP4。
查看完整指南读取图像
检查格式与任务生命周期。
查看完整指南响应头
如有 x-api-request-id,请连同错误时间保存以便排查。报告中不要包含 API 密钥或敏感请求内容。
查看完整指南故障排除
遵守 Retry-After,使用带随机抖动的指数退避,并限制次数与总时长。视频任务可能已创建时,先查询任务 ID,避免重复提交。
查看完整指南示例经过源码审查和本地检查,不代表已验证每个应用版本。正式使用前请检查设置、发送小型请求并确认用量。