API 参考
API 参考
AIZNT API 概览：Base URL、认证方式、错误码与兼容性说明。
AIZNT 是统一的大模型 API 网关，所有接口遵循 OpenAI 兼容格式，同时对 Claude、Gemini 的原生接口提供兼容支持。
完整接口文档
本章节介绍核心接口的用法。完整的接口清单、字段细节与在线调试请以当前控制台接口定义为准。
网关级请求体和多模态文件限制见限制与配额。
Base URL
https://token.aiznt.com认证方式
所有请求通过 HTTP Header 携带 API Key：
Authorization: Bearer sk-你的aiznt密钥API Key 在控制台「令牌管理」中创建，可按模型、IP、额度进行限制。
快速验证
curl https://token.aiznt.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的aiznt密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "你好"}]
}'接口一览
| 分类 | 接口 | 说明 |
|---|---|---|
| 聊天 | POST /v1/chat/completions | OpenAI 兼容聊天，支持流式、工具调用、多模态 |
| 聊天 | POST /v1/messages | Claude（Anthropic）原生消息接口 |
| 聊天 | POST /v1beta/models/{model}:generateContent | Gemini（Google）原生非流式生成 |
| 聊天 | POST /v1beta/models/{model}:streamGenerateContent | Gemini 原生流式生成 |
| 图片 | POST /v1/images/generations | GPT Image 文生图，返回 Base64 图片 |
| 图片 | POST /v1/images/edits | GPT Image 使用参考图编辑或扩展图片 |
| 图片 | POST /v1/images/generations | GPT Image 通用接口，按是否传入 image 生成或编辑 |
| 图片 | POST /v1/images/generations | Seedream 文生图与图生图 |
| 图片 | POST /v1/models/{model}:generateContent | Gemini 原生图片生成与编辑 |
| 图片 | POST /v1/images/generations | Gemini 图片通用兼容接口，返回图片 URL |
| 视频 | POST /api/v3/contents/generations/tasks | Seedance 创建视频生成任务 |
| 视频 | GET /api/v3/contents/generations/tasks/{task_id} | Seedance 查询任务状态与结果 |
| 视频 | MiniMax H3 | MiniMax H3 / H3 Max 创建与查询视频生成任务 |
| 视频 | Kling 3.0 Turbo | 文生视频：POST /text-to-video/kling-3.0-turbo；图生视频：POST /image-to-video/kling-3.0-turbo |
| 视频 | Kling 3.0 / 3.0 Omni | 文生：POST /text-to-video/kling-3.0；图生：POST /image-to-video/kling-3.0；Omni：POST /omni-video/kling-3.0-omni；动作控制：POST /motion-control/kling-3.0 |
| 视频 | Kling O1 | POST /omni-video/kling-o1，支持文本、图片、视频素材 |
| 视频 | GET /tasks | Kling 异步任务查询（按任务 ID 查询状态与结果） |
| 视频 | POST /tasks | Kling 异步任务分页查询（按时间、状态或产品类型筛选） |
| 管理 | GET /v1/models | 查询当前令牌可调用的模型列表 |
| 管理 | GET /v1/dashboard/billing/subscription | 查询令牌余额与用量 |
错误码
| HTTP 状态码 | 含义 |
|---|---|
| 400 | 请求参数错误（模型名拼写、参数缺失等） |
| 401 | API Key 无效或未携带 |
| 403 | 令牌无权限（模型未授权、IP 限制、额度耗尽） |
| 404 | 接口路径错误（检查是否带 /v1） |
| 429 | 触发速率限制 |
| 500 / 502 / 503 | 上游或网关错误，可重试 |
错误响应为 JSON，包含 error.message、error.type、error.code 字段。