ATokenAPI

    开发文档目录

    点击左侧目录,直接跳转到对应接口。

    基础接入 平台能力 基础信息 快速开始 AI 漫剧链路
    文本与图像 创建聊天补全 创建图像 Gemini 文本生成 Claude GPT Gemini Grok MAX banana MiniMax
    视频与音频 Kling 图像生成 Kling 对口型 语音合成 获取音乐 wav
    任务与管理 Imagen4 Preview 获取请求结果 批量获取任务 新增令牌 错误码 常见问题
    Token Relay Infrastructure

    ATokenAPI 多模型 Token 中转站开发文档

    ATokenAPI 面向 AI 应用、AI 漫剧企业、内容生产平台和企业内部 AI 系统,提供统一域名、统一 Token、统一额度和统一上游路由。你只需要接入 ATokenAPI,即可调用文本、图像、视频、语音、音乐等多模态模型能力。

    统一 Base URL Bearer Token 鉴权 额度池管理 多上游转发
    请求转发链路
    Client / Business App AI 漫剧系统、企业应用、自动化生产脚本
    ATokenAPI Gateway 鉴权、计费、限流、路由、任务状态聚合
    Text OpenAI / Claude / Gemini
    Media Kling / Luma / Suno / Fal.ai

    平台能力

    ATokenAPI 解决的是接入、稳定、成本和管理问题。

    Gateway
    统一转发入口 一个 ATokenAPI 域名承接多家模型接口,减少业务系统重复适配上游。
    Token
    密钥与额度管理 支持客户级 Token、额度池、过期时间、IP 白名单和用量控制。
    Route
    多上游模型路由 文本、图片、视频、语音、音乐按模型能力转发到不同上游。
    Task
    任务与结果聚合 异步任务统一创建、查询和回收结果,适合批量内容生产。

    基础信息

    接入前先配置服务地址和全局鉴权。

    配置项 值 说明
    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
      }'
    Apifox 环境变量建议:baseUrl=https://atokenapi.com,openaiBaseUrl=https://atokenapi.com/v1,apiKey=你的密钥。Bearer Token 里只填 {{apiKey}},不要写 Bearer 前缀。

    AI 漫剧生产链路

    从脚本到成片,把常用模型能力串成一条生产线。

    1
    剧本与分镜 生成剧情、台词、镜头描述和提示词。
    2
    角色与场景图 生成角色设定、场景图、封面图。
    3
    图生视频 生成镜头运动和短剧片段。
    4
    配音与对口型 TTS 配音,再进行视频口型同步。
    5
    任务轮询 批量查询任务状态并回收结果。

    接口文档

    下面是首页内置的完整接口说明,可直接作为开发文档使用。

    Claude 模型调用

    Claude 适合长文本理解、复杂推理、剧本润色、角色设定整理和企业文档分析。

    POST
    POST {{openaiBaseUrl}}/chat/completions
    请求示例
    {
      "model": "claude",
      "messages": [
        {
          "role": "user",
          "content": "帮我润色这段 AI 漫剧台词,让人物更有情绪张力。"
        }
      ],
      "stream": false
    }

    GPT 模型调用

    GPT 适合通用对话、工具调用、脚本生成、提示词优化和企业 AI 助手。

    POST
    POST {{openaiBaseUrl}}/chat/completions
    请求示例
    {
      "model": "gpt",
      "messages": [
        {
          "role": "user",
          "content": "生成一个 60 秒 AI 漫剧脚本,包含分镜、台词和画面提示词。"
        }
      ],
      "stream": false
    }

    Gemini 模型调用

    Gemini 适合多模态理解、长上下文处理、图片理解、视频脚本分析和内容改写。

    POST
    POST {{openaiBaseUrl}}/chat/completions
    请求示例
    {
      "model": "gemini",
      "messages": [
        {
          "role": "user",
          "content": "把这段剧情改写成更适合竖屏短视频的节奏。"
        }
      ],
      "stream": false
    }

    Grok 模型调用

    Grok 适合创意发散、社媒风格文案、实时内容理解和轻量对话场景。

    POST
    POST {{openaiBaseUrl}}/chat/completions
    请求示例
    {
      "model": "grok",
      "messages": [
        {
          "role": "user",
          "content": "给这个 AI 短剧想 10 个更有传播感的标题。"
        }
      ],
      "stream": false
    }

    MAX 模型调用

    MAX 适合高质量内容生成、复杂任务、重要生产请求和更稳定的输出场景。

    POST
    POST {{openaiBaseUrl}}/chat/completions
    请求示例
    {
      "model": "max",
      "messages": [
        {
          "role": "user",
          "content": "把这个故事扩写成完整的三幕式短剧大纲。"
        }
      ],
      "stream": false
    }

    banana 模型调用

    banana 适合图像、创意视觉和特定多模态能力接入,常用于角色图和视觉素材生成。

    POST
    POST {{openaiBaseUrl}}/images/generations
    请求示例
    {
      "model": "banana",
      "prompt": "AI 漫剧角色设定图,年轻男主,都市悬疑风格,电影感灯光",
      "size": "1024x1024",
      "n": 1
    }

    MiniMax 模型调用

    MiniMax 适合中文对话、内容生成、角色台词、剧情扩写和常规业务问答。

    POST
    POST {{openaiBaseUrl}}/chat/completions
    请求示例
    {
      "model": "minimax",
      "messages": [
        {
          "role": "user",
          "content": "用一句话介绍 ATokenAPI。"
        }
      ],
      "stream": false
    }

    创建聊天补全

    使用 OpenAI Chat Completions 兼容格式创建聊天补全请求。

    POST
    POST {{openaiBaseUrl}}/chat/completions
    请求参数
    modelstring,必填,模型名称。
    messagesarray,必填,对话消息列表。
    streamboolean,选填,是否开启流式输出。
    temperaturenumber,选填,生成随机性。
    请求示例
    {
      "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
    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
    POST {{baseUrl}}/v1beta/models/gemini-2.5-flash:generateContent
    请求示例
    {
      "contents": [
        {
          "role": "user",
          "parts": [
            {
              "text": "把这个短剧脚本改成更适合竖屏短视频的节奏。"
            }
          ]
        }
      ]
    }
    响应示例
    {
      "candidates": [
        {
          "content": {
            "parts": [
              {
                "text": "可以将开场压缩为 3 秒强冲突..."
              }
            ],
            "role": "model"
          }
        }
      ]
    }

    Kling 图像生成

    用于可灵图像生成或视频前置素材生成。

    POST
    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
    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
    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
    GET {{baseUrl}}/suno/act/wav/{clip_id}
    路径参数
    clip_idstring,必填,音乐片段 ID。
    响应示例
    {
      "code": 0,
      "message": "success",
      "data": {
        "wav_url": "https://example.com/music.wav"
      }
    }

    Imagen4 Preview

    用于 Fal.ai 图像生成队列任务。

    POST
    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
    GET {{baseUrl}}/fal-ai/{model_name}/requests/{request_id}
    路径参数
    model_namestring,必填,模型名称。
    request_idstring,必填,请求 ID。
    响应示例
    {
      "status": "COMPLETED",
      "images": [
        {
          "url": "https://example.com/result.png"
        }
      ]
    }

    批量获取任务

    用于批量查询 Luma 视频任务状态。

    POST
    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
    POST {{baseUrl}}/api/token/
    请求参数
    namestring,必填,Token 名称。
    remain_quotainteger,选填,初始额度。
    expired_timeinteger,选填,过期时间,-1 表示不过期。
    unlimited_quotaboolean,选填,是否不限额度。
    allow_ipsstring,选填,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。