ATokenAPI 多模型 Token 中转站开发文档
ATokenAPI 面向 AI 应用、AI 漫剧企业、内容生产平台和企业内部 AI 系统,提供统一域名、统一 Token、统一额度和统一上游路由。你只需要接入 ATokenAPI,即可调用文本、图像、视频、语音、音乐等多模态模型能力。
平台能力
ATokenAPI 解决的是接入、稳定、成本和管理问题。
基础信息
接入前先配置服务地址和全局鉴权。
| 配置项 | 值 | 说明 |
|---|---|---|
| OpenAI 兼容地址 | https://atokenapi.com/v1 |
用于 Chat Completions、Images 等 OpenAI 兼容接口。 |
| 多模态聚合地址 | https://atokenapi.com |
用于 Gemini、Kling、Luma、Fal.ai、Suno、Token 管理等接口。 |
| 鉴权方式 | Authorization: Bearer {{apiKey}} |
所有接口统一使用 Bearer Token。 |
快速开始
复制下面请求,替换 API Key 后即可测试。
curl https://atokenapi.com/v1/chat/completions \
-H "Authorization: Bearer sk-your-atokenapi-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{
"role": "user",
"content": "你好,介绍一下 ATokenAPI"
}
],
"stream": false
}'
baseUrl=https://atokenapi.com,openaiBaseUrl=https://atokenapi.com/v1,apiKey=你的密钥。Bearer Token 里只填 {{apiKey}},不要写 Bearer 前缀。AI 漫剧生产链路
从脚本到成片,把常用模型能力串成一条生产线。
接口文档
下面是首页内置的完整接口说明,可直接作为开发文档使用。
Claude 模型调用
Claude 适合长文本理解、复杂推理、剧本润色、角色设定整理和企业文档分析。
POST {{openaiBaseUrl}}/chat/completions
{
"model": "claude",
"messages": [
{
"role": "user",
"content": "帮我润色这段 AI 漫剧台词,让人物更有情绪张力。"
}
],
"stream": false
}GPT 模型调用
GPT 适合通用对话、工具调用、脚本生成、提示词优化和企业 AI 助手。
POST {{openaiBaseUrl}}/chat/completions
{
"model": "gpt",
"messages": [
{
"role": "user",
"content": "生成一个 60 秒 AI 漫剧脚本,包含分镜、台词和画面提示词。"
}
],
"stream": false
}Gemini 模型调用
Gemini 适合多模态理解、长上下文处理、图片理解、视频脚本分析和内容改写。
POST {{openaiBaseUrl}}/chat/completions
{
"model": "gemini",
"messages": [
{
"role": "user",
"content": "把这段剧情改写成更适合竖屏短视频的节奏。"
}
],
"stream": false
}Grok 模型调用
Grok 适合创意发散、社媒风格文案、实时内容理解和轻量对话场景。
POST {{openaiBaseUrl}}/chat/completions
{
"model": "grok",
"messages": [
{
"role": "user",
"content": "给这个 AI 短剧想 10 个更有传播感的标题。"
}
],
"stream": false
}MAX 模型调用
MAX 适合高质量内容生成、复杂任务、重要生产请求和更稳定的输出场景。
POST {{openaiBaseUrl}}/chat/completions
{
"model": "max",
"messages": [
{
"role": "user",
"content": "把这个故事扩写成完整的三幕式短剧大纲。"
}
],
"stream": false
}banana 模型调用
banana 适合图像、创意视觉和特定多模态能力接入,常用于角色图和视觉素材生成。
POST {{openaiBaseUrl}}/images/generations
{
"model": "banana",
"prompt": "AI 漫剧角色设定图,年轻男主,都市悬疑风格,电影感灯光",
"size": "1024x1024",
"n": 1
}MiniMax 模型调用
MiniMax 适合中文对话、内容生成、角色台词、剧情扩写和常规业务问答。
POST {{openaiBaseUrl}}/chat/completions
{
"model": "minimax",
"messages": [
{
"role": "user",
"content": "用一句话介绍 ATokenAPI。"
}
],
"stream": false
}创建聊天补全
使用 OpenAI Chat Completions 兼容格式创建聊天补全请求。
POST {{openaiBaseUrl}}/chat/completions
model | string,必填,模型名称。 |
messages | array,必填,对话消息列表。 |
stream | boolean,选填,是否开启流式输出。 |
temperature | number,选填,生成随机性。 |
{
"model": "gpt-4o-mini",
"messages": [
{
"role": "system",
"content": "你是一个专业的 AI 漫剧编剧助手。"
},
{
"role": "user",
"content": "帮我写一个 30 秒短剧开场。"
}
],
"stream": false
}{
"id": "chatcmpl_xxx",
"object": "chat.completion",
"choices": [
{
"message": {
"role": "assistant",
"content": "夜色压低,城市霓虹闪烁..."
},
"finish_reason": "stop"
}
]
}创建图像
用于角色设定图、场景图、封面图、分镜图生成。
POST {{openaiBaseUrl}}/images/generations
{
"model": "dall-e-3",
"prompt": "赛博朋克风格的 AI 漫剧女主角,半身像,电影感灯光",
"size": "1024x1024",
"n": 1
}{
"created": 1710000000,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}Gemini 文本生成
使用 Gemini 原生格式生成内容。
POST {{baseUrl}}/v1beta/models/gemini-2.5-flash:generateContent
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "把这个短剧脚本改成更适合竖屏短视频的节奏。"
}
]
}
]
}{
"candidates": [
{
"content": {
"parts": [
{
"text": "可以将开场压缩为 3 秒强冲突..."
}
],
"role": "model"
}
}
]
}Kling 图像生成
用于可灵图像生成或视频前置素材生成。
POST {{baseUrl}}/kling/v1/images/generations
{
"model_name": "kling-v1-5",
"prompt": "未来城市雨夜,女主角站在霓虹灯下,电影级构图",
"aspect_ratio": "9:16"
}{
"code": 0,
"message": "success",
"data": {
"task_id": "task_xxx",
"status": "submitted"
}
}Kling 对口型
将音频或文本同步到视频人物口型,适合 AI 漫剧角色配音。
POST {{baseUrl}}/kling/v1/videos/lip-sync
{
"input": {
"video_url": "https://example.com/character.mp4",
"mode": "text2video",
"text": "你终于来了,我等这一刻已经很久了。",
"voice_id": "girlfriend_1_speech02",
"voice_language": "zh"
}
}{
"code": 0,
"message": "success",
"data": {
"task_id": "lip_sync_task_xxx",
"status": "submitted"
}
}语音合成
用于生成角色配音、旁白、解说音频。
POST {{baseUrl}}/v1/audio/tts
{
"text": "夜幕降临,城市的秘密才刚刚开始。",
"voice_id": "genshin_vindi2",
"voice_language": "zh",
"voice_speed": "1.0"
}{
"code": 0,
"message": "success",
"data": {
"audio_url": "https://example.com/audio.wav"
}
}获取音乐 wav
用于获取 Suno 等音乐生成结果。
GET {{baseUrl}}/suno/act/wav/{clip_id}
clip_id | string,必填,音乐片段 ID。 |
{
"code": 0,
"message": "success",
"data": {
"wav_url": "https://example.com/music.wav"
}
}Imagen4 Preview
用于 Fal.ai 图像生成队列任务。
POST {{baseUrl}}/fal-ai/imagen4/preview
{
"prompt": "A cinematic vertical poster for an AI drama, neon city, dramatic lighting",
"aspect_ratio": "9:16",
"num_images": 1,
"resolution": "1K"
}{
"request_id": "req_xxx",
"status": "IN_QUEUE"
}获取请求结果
查询 Fal.ai 异步任务结果。
GET {{baseUrl}}/fal-ai/{model_name}/requests/{request_id}
model_name | string,必填,模型名称。 |
request_id | string,必填,请求 ID。 |
{
"status": "COMPLETED",
"images": [
{
"url": "https://example.com/result.png"
}
]
}批量获取任务
用于批量查询 Luma 视频任务状态。
POST {{baseUrl}}/luma/tasks
{
"ids": [
"4665a07c-7641-4809-a133-10786201bb56"
]
}{
"tasks": [
{
"id": "4665a07c-7641-4809-a133-10786201bb56",
"status": "completed",
"video_url": "https://example.com/video.mp4"
}
]
}新增令牌
用于在企业后台或管理系统中创建客户 Token。
POST {{baseUrl}}/api/token/
name | string,必填,Token 名称。 |
remain_quota | integer,选填,初始额度。 |
expired_time | integer,选填,过期时间,-1 表示不过期。 |
unlimited_quota | boolean,选填,是否不限额度。 |
allow_ips | string,选填,IP 白名单。 |
{
"name": "客户A-生产环境",
"remain_quota": 250000000000,
"expired_time": -1,
"unlimited_quota": false,
"allow_ips": ""
}{
"success": true,
"message": "token created",
"data": {
"key": "sk-atokenapi-xxx",
"name": "客户A-生产环境",
"remain_quota": 250000000000
}
}错误码
建议所有接口统一错误结构,方便客户排查。
| HTTP 状态码 | 说明 | 处理方式 |
|---|---|---|
| 400 | 请求参数错误 | 检查 JSON 格式和必填参数。 |
| 401 | 鉴权失败 | 检查 Authorization 和 API Key。 |
| 403 | 无权限或额度不足 | 检查 Token 权限、余额和白名单。 |
| 404 | 接口或模型不存在 | 检查路径和模型名称。 |
| 429 | 请求过于频繁 | 降低并发或联系管理员提升限制。 |
| 500 | 服务内部错误 | 稍后重试或联系技术支持。 |
| 502 | 上游服务异常 | 切换模型或稍后重试。 |
常见问题
接入时最常见的问题可以先看这里。
为什么报 401?
通常是 API Key 没填、填错,或者 Bearer Token 配置错误。正确格式是 Authorization: Bearer sk-your-atokenapi-key。
为什么报 404?
检查是否把地址写成了 https://atokenapi.com/v1/v1/chat/completions。如果 Base URL 已经是 https://atokenapi.com/v1,路径就应该是 /chat/completions。
流式输出怎么开启?
在请求 Body 中设置 "stream": true。客户端需要按 SSE 或流式响应方式读取。
异步任务怎么处理?
视频、音乐、图片队列类接口通常先返回 task_id 或 request_id。保存 ID 后,每隔几秒调用查询接口,状态完成后读取 video_url、audio_url 或 image_url。
