# LoopToken API 文档

> OpenAI 兼容的 LLM / 图像 / 视频 / 音频 API 网关;Claude 系列走 Anthropic 原生 Messages API(POST /v1/messages,也接受 x-api-key 鉴权)。域名 https://api.vibelab.me ,多数接口在 /v1 下;例外:Kling 原生接口(/text-to-video/* 等,无 /v1)、Seedance 方舟原生(/api/v3)、素材库(/hub/api/v3),路径以各页为准。鉴权 Authorization: Bearer <API Key>。各接口家族的路径、查询方式与终态对照见「快速开始」页「接口家族」一节。完整文档合集见 https://looptoken.vibelab.me/docs/llms-full.txt 。

- [账户与用量](https://looptoken.vibelab.me/docs/llms.mdx/account-usage/content.md): 用 API Key 查询账户余额、今日/本月/累计用量、Key 配额，以及单个任务实际扣除的积分
- [鉴权](https://looptoken.vibelab.me/docs/llms.mdx/authentication/content.md): 所有 /v1/* 接口使用 Authorization Bearer sk-lt-... 鉴权（Claude 的 /v1/messages 也接受 x-api-key）；API Key 的配额、模型白名单、IP 白名单与限流行为
- [Claude Code 接入](https://looptoken.vibelab.me/docs/llms.mdx/claude-code/content.md): 用原生 Anthropic Messages API 把 Claude Code 接入 LoopToken：环境变量、settings.json、模型选择、验收命令与常见问题
- [Codex 接入](https://looptoken.vibelab.me/docs/llms.mdx/codex-ccswitch/content.md): 用 Responses API 把 Codex CLI / Codex App、CC Switch 接入 LoopToken：配置文件、验收命令与常见问题
- [错误码](https://looptoken.vibelab.me/docs/llms.mdx/errors/content.md): 统一错误响应体、错误码总表（HTTP 状态码、触发场景）与重试建议
- [快速开始](https://looptoken.vibelab.me/docs/llms.mdx/content.md): LoopToken 统一 API：一个 Key 调用对话、图像、视频、音乐、语音与转写模型，兼容 OpenAI SDK
- [模型列表](https://looptoken.vibelab.me/docs/llms.mdx/models/content.md): 当前可用模型与实时价格
- [音乐生成（Flow Music）](https://looptoken.vibelab.me/docs/llms.mdx/audio/flowmusic/content.md): flowmusic（Lyria 3 Pro / Lyria 3.5）：生成音乐、歌词、延伸、片段替换、Cover 改编、词曲分离、音乐视频，异步，用 GET /v1/music/tasks/{task_id} 查询
- [文字转语音](https://looptoken.vibelab.me/docs/llms.mdx/audio/speech/content.md): gpt-4o-mini-tts / tts-1：OpenAI 兼容文字转语音，同步，响应体直接是音频二进制
- [音乐生成（Suno）](https://looptoken.vibelab.me/docs/llms.mdx/audio/suno/content.md): suno（V6 / V6 Wild / V6 Mini）全部音乐操作：生成歌曲、歌词、续写、翻唱、分轨、MIDI、音乐视频等，异步，用 GET /v1/music/tasks/{task_id} 查询
- [音频转写](https://looptoken.vibelab.me/docs/llms.mdx/audio/transcriptions/content.md): whisper-1：OpenAI 兼容音频转写，同步，multipart 上传，返回文本、时间戳或字幕
- [Claude 系列](https://looptoken.vibelab.me/docs/llms.mdx/chat/claude/content.md): Anthropic Claude（claude-fable-5-1 / claude-opus-5-5 / claude-sonnet-5-5 / claude-haiku-5-5），原生 Anthropic Messages API（POST /v1/messages），同步或 SSE 流式，按输入/输出/缓存读取/缓存写入五项计费
- [DeepSeek 系列](https://looptoken.vibelab.me/docs/llms.mdx/chat/deepseek/content.md): DeepSeek V4 系列通用模型，OpenAI 兼容，同步或 SSE 流式
- [Gemini 系列](https://looptoken.vibelab.me/docs/llms.mdx/chat/gemini/content.md): Google Gemini 对话模型（gemini-3.5-flash 等），OpenAI 格式调用，同步或 SSE 流式，gemini-3.1-pro-preview 支持视频输入
- [GPT 系列](https://looptoken.vibelab.me/docs/llms.mdx/chat/gpt/content.md): OpenAI GPT 系列对话模型（gpt-6.1-* / gpt-6-* / gpt-5.6-* / gpt-5.5 / gpt-5.4），按官方原价计费，支持缓存、长上下文与 Fast 档
- [接口说明](https://looptoken.vibelab.me/docs/llms.mdx/chat/content.md): POST /v1/chat/completions：除 Claude 外全部对话模型共用的 OpenAI Chat Completions 兼容协议，同步或 SSE 流式，按 token 计费
- [GPT Image 2.6](https://looptoken.vibelab.me/docs/llms.mdx/images/gpt-image-2-6/content.md): gpt-image-2.6-flare / gpt-image-2.6-sunburst 文生图、图生图、局部重绘，同步，按 token 计费
- [GPT Image 2 Official](https://looptoken.vibelab.me/docs/llms.mdx/images/gpt-image-2-official/content.md): gpt-image-2-official 文生图、图生图、局部重绘，同步，按 token 计费
- [GPT Image 系列](https://looptoken.vibelab.me/docs/llms.mdx/images/gpt-image/content.md): gpt-image-2、gpt-image-2-lite、gpt-image-2-ext、gpt-image-2.5-ext 同步文生图与编辑，按成功图片数计费
- [Grok Imagine](https://looptoken.vibelab.me/docs/llms.mdx/images/grok-imagine/content.md): grok-imagine-1.5 文生图与 grok-imagine-1.5-edit 图片编辑，同步，返回 OpenAI Images 格式
- [图片生成](https://looptoken.vibelab.me/docs/llms.mdx/images/content.md): POST /v1/images/generations 与 /v1/images/edits：全部图片模型共用的同步接口，各模型请求协议与响应格式差异、选型对照
- [Nano Banana 系列](https://looptoken.vibelab.me/docs/llms.mdx/images/nano-banana/content.md): nano-banana、nano-banana-pro、nano-banana-2、nano-banana-2-lite、nano-banana-2.1 图片生成与参考图编辑，同步返回 OpenAI Images 格式
- [其他图片模型](https://looptoken.vibelab.me/docs/llms.mdx/images/other-models/content.md): z-image-turbo：快速文生图，每次固定一张，同步，返回 OpenAI Images 格式
- [Seedream 系列](https://looptoken.vibelab.me/docs/llms.mdx/images/seedream/content.md): Doubao-seedream-4.0 / 4.5、Doubao-Seedream-5.0-lite、doubao-seedream-5.0-pro：文生图、参考图生图与组图，同步，响应为 OpenAI Images data[]
- [Wan 图片系列](https://looptoken.vibelab.me/docs/llms.mdx/images/wan/content.md): wan2.7-image / wan2.7-image-pro：扁平协议，支持文生图、编辑、参考图与序列生成，同步，响应为 OpenAI Images data[]
- [操作详解](https://looptoken.vibelab.me/docs/llms.mdx/midjourney/actions/content.md): Midjourney 16 个操作的端点、字段与父任务要求，含 blend/upscale/pan/zoom/inpaint/video
- [接口说明](https://looptoken.vibelab.me/docs/llms.mdx/midjourney/content.md): midjourney：异步任务协议，提交 imagine 与 16 种二次操作，用 GET /v1/midjourney/{task_id} 轮询，状态 SUCCESS / FAILURE
- [Grok Imagine 1.5 Video](https://looptoken.vibelab.me/docs/llms.mdx/video/grok-video/content.md): grok-imagine-1.5-video：文生/图生视频，6–30 秒、480p/720p，异步，按秒计费，用 GET /v1/tasks/{task_id} 查询
- [接口说明](https://looptoken.vibelab.me/docs/llms.mdx/video/content.md): 视频生成 /v1 统一异步协议：POST /v1/videos/generations 提交，GET /v1/tasks/{task_id} 轮询任务对象，支持 callback_url 回调
- [主流视频模型](https://looptoken.vibelab.me/docs/llms.mdx/video/mainstream/content.md): sora-2、veo3.1、MiniMax-Hailuo-2.3、minimax-h3 的统一扁平字段视频接口，文生/图生，异步，用 GET /v1/tasks/{task_id} 查询
- [H3 视频生成](https://looptoken.vibelab.me/docs/llms.mdx/video/minimax-h3/content.md): minimax-h3：文生视频、首尾帧、多模态参考生成，4–15 秒、768P/2K，异步，用 GET /v1/tasks/{task_id} 查询
- [MiniMax Hailuo 2.3](https://looptoken.vibelab.me/docs/llms.mdx/video/minimax-hailuo-23/content.md): MiniMax-Hailuo-2.3：文生/首帧图生视频，6 或 10 秒，768p/1080p，异步，用 GET /v1/tasks/{task_id} 查询
- [Omni Flash 系列](https://looptoken.vibelab.me/docs/llms.mdx/video/omni-flash/content.md): omni-flash-ext 与 gemini-omni-flash-preview：文生、参考视频驱动、图生与视频编辑，异步，按条计费，用 GET /v1/tasks/{task_id} 查询
- [Pixverse v6](https://looptoken.vibelab.me/docs/llms.mdx/video/pixverse/content.md): pixverse-v6：文生/首尾帧/多参考图视频，1–15 秒、360p–1080p，可选人声音效，异步，用 GET /v1/tasks/{task_id} 查询
- [虚拟人像素材入库](https://looptoken.vibelab.me/docs/llms.mdx/video/private-avatar/content.md): seedance2-private-avatar：POST /v1/seedance2/private-avatar 虚拟人像素材异步入库，GET 查询审核结果，免费
- [Seedance 方舟原生接口](https://looptoken.vibelab.me/docs/llms.mdx/video/seedance-ark/content.md): Seedance 2.0 与 2.5 的方舟原生协议：POST /api/v3/contents/generations/tasks 创建，GET 单任务查询与列表，异步，支持草稿与回调
- [Seedance 方舟原生素材库版](https://looptoken.vibelab.me/docs/llms.mdx/video/seedance-native-assets/content.md): Seedance 方舟原生素材库版：素材组与素材管理、真人认证，以及 /hub/api/v3 视频创建、查询、列表、删除，异步
- [Seedance 系列](https://looptoken.vibelab.me/docs/llms.mdx/video/seedance/content.md): Seedance 2.0/2.5 全系列：文生、首帧、首尾帧、参考图/视频/音频生成与 2.5 编辑延长，/v1 异步，用 GET /v1/tasks/{task_id} 查询
- [SkyReels V4](https://looptoken.vibelab.me/docs/llms.mdx/video/skyreels/content.md): skyreels-v4-fast、skyreels-v4-std：文生/首尾帧/参考图与参考视频生成，3–15 秒、480p–1080p，异步，用 GET /v1/tasks/{task_id} 查询
- [Sora 2](https://looptoken.vibelab.me/docs/llms.mdx/video/sora2/content.md): sora-2 与 sora-2-pro：文生/图生视频，4–20 秒，异步，用 GET /v1/tasks/{task_id} 查询
- [Veo 3.1](https://looptoken.vibelab.me/docs/llms.mdx/video/veo31/content.md): veo3.1-fast、veo3.1-quality、veo3.1-lite：文生/图生视频，固定 8 秒，异步，用 GET /v1/tasks/{task_id} 查询
- [Vidu Q3 系列](https://looptoken.vibelab.me/docs/llms.mdx/video/vidu/content.md): viduq3、viduq3-mix、viduq3-pro、viduq3-turbo：多参考图/文生/图生/首尾帧视频，1–16 秒、540p–1080p，异步，用 GET /v1/tasks/{task_id} 查询
- [Wan 视频](https://looptoken.vibelab.me/docs/llms.mdx/video/wan/content.md): wan3.0-video / wan3.0-video-prime：DashScope 风格 input + parameters 的异步视频生成，支持文生、首尾帧、参考生成与视频编辑，480P/720P/1080P，用 GET /v1/tasks/{task_id} 查询
- [创建数字人任务](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/avatar-create/content.md): POST /v1/videos/avatar/image2video：用一张人像和一段音频生成口播视频，异步
- [查询数字人任务](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/avatar-get/content.md): GET /v1/videos/avatar/image2video/{id}：按 task_id 或 external_task_id 查询数字人任务
- [数字人任务列表](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/avatar-list/content.md): GET /v1/videos/avatar/image2video：分页列出数字人任务
- [主体管理](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/elements/content.md): /v1/general/*：创建、查询和删除 Kling 主体，以及查询官方主体库；创建异步，用 GET /v1/general/advanced-custom-elements/{id} 查询
- [查询任务](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/get-tasks/content.md): GET /tasks：按任务 ID 或自定义任务 ID 查询文生视频、图生视频、动作控制、全能参考视频任务
- [人脸识别](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/identify-face/content.md): POST /v1/videos/identify-face：识别视频中可对口型的人脸，对口型的前置步骤，同步
- [图像识别](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/image-recognize/content.md): POST /v1/videos/image-recognize：识别图片中的主体、人脸和服装，同步
- [图生视频](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/image-to-video/content.md): POST /image-to-video/{model}：可灵 3.0 / 3.0 Turbo 图生视频，异步，用 GET /tasks 查询
- [Kling 原生接口](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/content.md): 可灵 4.0 / 3.0 / 3.0 Turbo 视频生成、动作控制、数字人、音效、对口型、多模态编辑、图像识别，路径与字段和可灵官方 API 一致
- [Kling 4.0 视频生成](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/kling-4/content.md): kling-4.0：文生视频、多关键帧图生视频、全能参考生成与视频编辑，3–30 秒、720p/1080p，异步，用 GET /tasks 查询
- [创建对口型任务](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/lip-sync-create/content.md): POST /v1/videos/advanced-lip-sync：让视频中的人脸对上指定音频的口型，异步
- [查询对口型任务](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/lip-sync-get/content.md): GET /v1/videos/advanced-lip-sync/{id}：按 task_id 或 external_task_id 查询对口型任务
- [对口型任务列表](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/lip-sync-list/content.md): GET /v1/videos/advanced-lip-sync：分页列出对口型任务
- [按游标列出任务](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/list-tasks/content.md): POST /tasks：按时间窗口和状态游标分页列出文生视频、图生视频、动作控制、全能参考视频任务
- [动作控制](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/motion-control/content.md): POST /motion-control/kling-3.0：用参考视频的动作驱动参考图中的人物，异步，用 GET /tasks 查询
- [增加视频选区](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/multi-elements-add-selection/content.md): POST /v1/videos/multi-elements/add-selection：增加视频选区，同步
- [清除视频选区](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/multi-elements-clear-selection/content.md): POST /v1/videos/multi-elements/clear-selection：清除视频选区，同步
- [创建多模态编辑任务](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/multi-elements-create/content.md): POST /v1/videos/multi-elements：对视频增加、替换或删除元素，异步
- [删减视频选区](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/multi-elements-delete-selection/content.md): POST /v1/videos/multi-elements/delete-selection：删减视频选区，同步
- [查询多模态编辑任务](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/multi-elements-get/content.md): GET /v1/videos/multi-elements/{id}：按 task_id 或 external_task_id 查询多模态编辑任务
- [初始化待编辑视频](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/multi-elements-init-selection/content.md): POST /v1/videos/multi-elements/init-selection：多模态视频编辑第一步，初始化视频并得到 session_id，同步
- [多模态编辑任务列表](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/multi-elements-list/content.md): GET /v1/videos/multi-elements：分页列出多模态编辑任务
- [预览已选区视频](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/multi-elements-preview-selection/content.md): POST /v1/videos/multi-elements/preview-selection：预览已选区视频，同步
- [创建文生音效任务](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/text-to-audio-create/content.md): POST /v1/audio/text-to-audio：用文字描述生成 3–10 秒音效，异步
- [查询文生音效任务](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/text-to-audio-get/content.md): GET /v1/audio/text-to-audio/{id}：按 task_id 或 external_task_id 查询文生音效任务
- [文生音效任务列表](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/text-to-audio-list/content.md): GET /v1/audio/text-to-audio：分页列出文生音效任务
- [文生视频](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/text-to-video/content.md): POST /text-to-video/{model}：可灵 3.0 / 3.0 Turbo 文生视频，异步，用 GET /tasks 查询
- [音色管理](https://looptoken.vibelab.me/docs/llms.mdx/video/kling/voices/content.md): /v1/general/*：创建、查询和删除 Kling 音色，以及查询官方音色库；创建异步，用 GET /v1/general/custom-voices/{id} 查询