开发者文档 · API V1

API Stack 集成文档

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

1

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.

Mở Quản lý Key →
2

Chọn Base URL

Dùng https://apistack.vn cho Anthropic / Claude Code hoặc https://apistack.vn/v1 cho OpenAI SDK.

Xem chi tiết URL →
3

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
查看完整指南

连接应用

按工具和协议查找指南。

← 全部应用

请求生命周期

从 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,避免重复提交。

查看完整指南

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

Support