返回首页接入区

使用文档:API 接入

llmgate 兼容 OpenAI `/v1` 调用方式。业务侧只需要替换 API Key 和 base_url,模型名仍使用平台公开的标准模型名。

API 入口

https://api.llmgate.shop/v1

文本示例模型

doubao-seed-2-0-pro-260215

图片示例模型

doubao-seedream-5-0-lite

Integration

API 接入流程

01

管理员创建账号并充值

由后台管理员创建账号后完成钱包充值,所有 API Key 共用同一个用户钱包。

02

创建 API Key

在控制台生成 sk-lg-*,业务侧使用同一个 Key 走统一鉴权。

03

替换 base_url

当前 API 入口为 https://api.llmgate.shop/v1。

04

发送测试请求

用公开模型名发起一次最小请求,再到控制台调用记录核对 requestId、token 和扣费。

OpenAI-compatible

API 支持接口

业务系统只需要接入下列入口;控制台、后台和支付回调使用的 `/api/*` 属于站内接口,不作为第三方集成入口。

MethodPath
GET/v1/models无需 API Key返回模型列表、可调用状态、能力、产品渠道和当前价格,供业务系统接入前查询。
POST/v1/chat/completionsBearer sk-lg-*业务系统主调用入口,兼容 OpenAI Chat Completions 的 model、messages、stream 和 tools。
POST/v1/images/generationsBearer sk-lg-*图片生成入口,JSON 请求。不同图片模型支持的 size、resolution、参考图和返回格式不一样,按下方模型参数表接入。
POST/v1/images/editsBearer sk-lg-*图片编辑入口,multipart/form-data 请求,支持 image 原图、mask、prompt、model、n、size、response_format、output_format、output_compression、input_fidelity、partial_images 和 stream。
POST/v1/videos/generationsBearer sk-lg-*视频生成同步入口,JSON 请求;当前异步视频线路(Seedance、HappyHorse)只要返回可轮询 `task_id` 就统一进入 `status=running`,即使响应里已经带 usage 也不会立刻成功扣费;只有拿到可交付视频 URL 才能是成功终态。
GET/v1/videos/generations/{task_id}Bearer sk-lg-*查询同步视频入口返回的公开视频任务状态;异步视频线路(Seedance、HappyHorse)的 `{task_id}` 兼容上游 task_id 和本次 request_id。响应同样统一顶层 `id`、`task_id`、`status` 和 `video_urls`。已知还在生成中的任务遇到一次上游轮询 5xx 会继续返回 `status=running`,只有 `status=failed` 才代表最终失败。异步任务不要用这个接口,改用 /tasks/{taskId}。
POST/v1/images/generations/asyncBearer sk-lg-*图片生成异步入口,复用同步图片生成 JSON 请求体和对应模型参数规则;创建成功返回 202 和 generation.task。
GET/v1/images/generations/tasks/{taskId}Bearer sk-lg-*查询图片生成异步任务状态和结果,只返回当前 API Key 所属账户的任务。
DELETE/v1/images/generations/tasks/{taskId}Bearer sk-lg-*取消尚未提交到上游的图片生成异步任务;已提交或运行中的任务会返回 409。
POST/v1/images/edits/asyncBearer sk-lg-*图片编辑异步入口,复用同步图片编辑 multipart/form-data 请求体;任务接口不返回 SSE,创建任务时会忽略 stream 和 partial_images。
GET/v1/images/edits/tasks/{taskId}Bearer sk-lg-*查询图片编辑异步任务状态和结果,只返回当前 API Key 所属账户的任务。
DELETE/v1/images/edits/tasks/{taskId}Bearer sk-lg-*取消尚未提交到上游的图片编辑异步任务;已提交或运行中的任务会返回 409。
POST/v1/videos/generations/asyncBearer sk-lg-*视频生成异步入口,复用同步视频生成 JSON 请求体;推荐长耗时视频任务使用。
GET/v1/videos/generations/tasks/{taskId}Bearer sk-lg-*查询视频生成异步任务状态和结果,平台 worker 负责上游轮询和媒体转存。
DELETE/v1/videos/generations/tasks/{taskId}Bearer sk-lg-*取消尚未提交到上游的视频生成异步任务;已提交或运行中的任务会返回 409。
GET/v1/usageBearer sk-lg-*查询当前账户自己的调用日志列表,支持按时间、request_id、模型、状态和 API Key 过滤。
GET/v1/usage/{request_id}Bearer sk-lg-*按 request_id 查询单次调用的 token、扣费、状态、用户可见错误信息,以及同步视频异步收口耗时摘要。

Image Generation

生图模型参数

生图参数按模型看,不同模型不要混用。同步和异步图片生成使用同一套 JSON 请求体。

Doubao Seedream 5.0 Lite

doubao-seedream-5-0-lite
/v1/images/generations/v1/images/generations/async

公开生图模型,适合常规文生图和参考图生成。当前平台标准渠道按张计费。

Parameter说明
model

必填,使用当前小节的公开模型名。

prompt

必填,图片生成提示词,字符串。

size

可选。可传清晰度档位、比例或像素尺寸;平台会按当前模型的官方尺寸规则归一后再请求上游。

resolution

可选,平台兼容字段。传了它就按它决定清晰度档位;没传时平台从 size 推断。

image / reference_images / images

可选参考图,支持 URL 或 data URL;image 适合单张参考图,数组字段适合多张参考图。

use_reference_image_size

可选布尔值。只对 Seedream 生图生效;显式传了非空 size 时以 size 为准。未传 size 且带参考图时,平台读取第一张 data URL 或公网 URL 参考图宽高作为尺寸来源;缺参考图、URL 不安全或读不到宽高会返回 HTTP 400。

n

可选,生成张数;按实际生成张数计费。

response_format

可选,常用 urlb64_json,实际返回格式以当前线路能力为准。

watermark

可选,是否添加 AI 生成水印,布尔值;传 false 时不加水印。

size / resolution values

2K3K4K;也可传 1:116:99:16 等比例或 WIDTHxHEIGHT1K 会按平台兼容规则归一到 Seedream 可接收的尺寸。

未传 sizeresolution 时,平台默认按 2K 请求。

自定义像素必须能归一到模型可接受的范围;不支持的 sizeresolution 会直接返回 HTTP 400,不会扣费。

官网有但当前平台线路不开放/未确认的参数

官网参数当前平台线路状态
stream

官网有流式相关能力;当前 Seedream 公开线路按同步结果或异步任务推进,不承诺图片流式响应。

sequential_image_generation

官网有连续生图能力;当前公开 Seedream 图片线路未验收,不作为用户侧可用参数。

sequential_image_generation_options

官网有连续生图配置;依赖连续生图能力,当前公开线路不开放。

tools

官网有工具能力,例如联网搜索;当前公开 Seedream 图片线路未验收,不承诺生效。

optimize_prompt_options

官网有提示词优化配置;当前公开线路未验收,不开放给用户端依赖。

Seedream 5.0 Lite 图片生成

curl https://api.llmgate.shop/v1/images/generations \
  -H "Authorization: Bearer sk-lg-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-lite",
    "prompt": "A clean product photo of a ceramic coffee cup",
    "size": "3K",
    "image": "https://example.com/reference.png",
    "n": 1,
    "response_format": "url"
  }'

Doubao Seedream 4.5

doubao-seedream-4-5
/v1/images/generations/v1/images/generations/async

公开生图模型,适合高质量文生图和参考图生成。当前平台标准渠道按张计费。

Parameter说明
model

必填,使用当前小节的公开模型名。

prompt

必填,图片生成提示词,字符串。

size

可选。可传清晰度档位、比例或像素尺寸;平台会按当前模型的官方尺寸规则归一后再请求上游。

resolution

可选,平台兼容字段。传了它就按它决定清晰度档位;没传时平台从 size 推断。

image / reference_images / images

可选参考图,支持 URL 或 data URL;image 适合单张参考图,数组字段适合多张参考图。

use_reference_image_size

可选布尔值。只对 Seedream 生图生效;显式传了非空 size 时以 size 为准。未传 size 且带参考图时,平台读取第一张 data URL 或公网 URL 参考图宽高作为尺寸来源;缺参考图、URL 不安全或读不到宽高会返回 HTTP 400。

n

可选,生成张数;按实际生成张数计费。

response_format

可选,常用 urlb64_json,实际返回格式以当前线路能力为准。

watermark

可选,是否添加 AI 生成水印,布尔值;传 false 时不加水印。

size / resolution values

2K4K;也可传 1:116:99:16 等比例或 WIDTHxHEIGHT3K 不属于当前模型公开支持档位。

未传 sizeresolution 时,平台默认按 2K 请求。

doubao-seedream-4-5 不写 3K,避免业务侧按另一个模型的能力误传参数。

官网有但当前平台线路不开放/未确认的参数

官网参数当前平台线路状态
stream

官网有流式相关能力;当前 Seedream 公开线路按同步结果或异步任务推进,不承诺图片流式响应。

sequential_image_generation

官网有连续生图能力;当前公开 Seedream 图片线路未验收,不作为用户侧可用参数。

sequential_image_generation_options

官网有连续生图配置;依赖连续生图能力,当前公开线路不开放。

tools

官网有工具能力,例如联网搜索;当前公开 Seedream 图片线路未验收,不承诺生效。

optimize_prompt_options

官网有提示词优化配置;当前公开线路未验收,不开放给用户端依赖。

Seedream 4.5 图片生成

curl https://api.llmgate.shop/v1/images/generations \
  -H "Authorization: Bearer sk-lg-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5",
    "prompt": "A clean product photo of a ceramic coffee cup",
    "size": "4K",
    "image": "https://example.com/reference.png",
    "n": 1,
    "response_format": "url"
  }'

Video Generation

生视频模型参数

生视频参数也按模型看。长耗时任务建议走异步接口,再轮询任务状态。

Doubao Seedance 2.0

doubao-seedance-2-0
/v1/videos/generations/v1/videos/generations/async

公开生视频模型,支持文生视频、图生视频和多模态参考素材。长耗时任务建议走异步接口。

Parameter说明
model

必填,使用当前小节的公开模型名。

content

必填,官方内容数组。至少包含一个文本提示词或一个参考素材块;参考图、视频、音频分别使用 image_urlvideo_urlaudio_url。素材 URL 必须能被当前上游线路读取。

duration

可选,视频时长,按模型和上游当前能力取值。

ratio

可选,Seedance 官方画面比例枚举:16:94:31:13:49:1621:9adaptive。Seedance 2.0 / 2.0 fast 不传时,平台按官方默认补齐为 adaptive 再提交上游,模型会根据参考素材和输入内容选择画幅;需要强制横屏、竖屏或方图时再传固定枚举。

resolution

可选,Seedance 官方分辨率字段,建议使用 480p720p1080p4k;不传时按 720p 判档。平台额外兼容 video_resolutionvideoResolutionsize 作为分辨率别名,但推荐新接入只传 resolution

generate_audio

可选,是否生成音频,布尔值。

watermark

可选,是否加水印,布尔值。

seed

可选,随机种子,整数。

return_last_frame

可选,是否返回尾帧,布尔值。

tools

可选。需要联网搜索时传 [{"type":"web_search"}];不用搜索时不要传。

首尾帧用 role: "first_frame" / role: "last_frame";普通参考图用 role: "reference_image"。尾帧不能单独使用,必须同时有首帧。

公开 /v1/videos/generations/v1/videos/generations/async 当前不会代建上游素材组或素材,也不开放素材库 CRUD。API 客户只按 content 提交普通参考素材 URL,不要传 asset://、控制台素材 ID、素材组 ID、上游素材 ID、上游任务 ID 或供应商专用审核参数。网页控制台使用持久平台素材库,并在生成时按最终实际线路自动选择短期签名 URL 或隔离的上游素材副本。

同步入口可能直接返回视频,也可能返回上游任务;异步视频线路(Seedance、HappyHorse)会把不同上游的任务包装统一成顶层 idtask_idstatusvideo_urls。只要响应里有可轮询 task id,就按 status=running 返回并创建内部收口任务,即使上游同时返回 usage 也不会立即成功扣费;如果提交阶段某条异步视频上游 HTTP 200 但没有 task id 也没有视频 URL,会按 UPSTREAM_VIDEO_RESULT_MISSING 记当前线路失败并继续 fallback,所有候选都不可交付时才失败。已知运行中的同步视频查询遇到临时上游轮询 5xx 时继续返回 status=running;任务已经成功落到平台媒体后,查询优先返回平台转存后的视频地址。平台异步入口会由 worker 负责轮询、转存和结算。

官网有但当前平台线路不开放/未确认的参数

官网参数当前平台线路状态
callback_url

官网有回调地址;平台公开异步任务不开放客户回调,统一由平台 worker 轮询、转存和结算,客户查询 /tasks/{taskId}

Seedance 2.0 视频生成

curl https://api.llmgate.shop/v1/videos/generations \
  -H "Authorization: Bearer sk-lg-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [
      {"type": "text", "text": "A short cinematic shot of a coffee cup on a wooden desk"},
      {"type": "image_url", "image_url": {"url": "https://example.com/reference.png"}, "role": "reference_image"}
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "1080p",
    "generate_audio": true,
    "watermark": false
  }'

Seedance 2.0 首尾帧视频生成

curl https://api.llmgate.shop/v1/videos/generations \
  -H "Authorization: Bearer sk-lg-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [
      {"type": "text", "text": "Make a smooth cinematic transition from the first image to the second image"},
      {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/first-frame.png"}},
      {"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/last-frame.png"}}
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "1080p",
    "generate_audio": false,
    "watermark": false,
    "return_last_frame": true
  }'

Doubao Seedance 2.0 Fast

doubao-seedance-2-0-fast
/v1/videos/generations/v1/videos/generations/async

公开生视频模型,优先速度。请求体和 Seedance 2.0 保持同一套官方内容数组写法。

Parameter说明
model

必填,使用当前小节的公开模型名。

content

必填,官方内容数组。至少包含一个文本提示词或一个参考素材块;参考图、视频、音频分别使用 image_urlvideo_urlaudio_url。素材 URL 必须能被当前上游线路读取。

duration

可选,视频时长,按模型和上游当前能力取值。

ratio

可选,Seedance 官方画面比例枚举:16:94:31:13:49:1621:9adaptive。Seedance 2.0 / 2.0 fast 不传时,平台按官方默认补齐为 adaptive 再提交上游,模型会根据参考素材和输入内容选择画幅;需要强制横屏、竖屏或方图时再传固定枚举。

resolution

可选,Seedance 官方分辨率字段,建议使用 480p720p1080p4k;不传时按 720p 判档。平台额外兼容 video_resolutionvideoResolutionsize 作为分辨率别名,但推荐新接入只传 resolution

generate_audio

可选,是否生成音频,布尔值。

watermark

可选,是否加水印,布尔值。

seed

可选,随机种子,整数。

return_last_frame

可选,是否返回尾帧,布尔值。

Fast 模型不要照搬图片模型的 prompt + image 写法;视频请求用 content 数组。首尾帧同样使用 first_frame / last_frame 角色。

公开 /v1/videos/generations/v1/videos/generations/async 当前不会代建上游素材组或素材,也不开放素材库 CRUD。API 客户只按 content 提交普通参考素材 URL,不要传 asset://、控制台素材 ID、素材组 ID、上游素材 ID、上游任务 ID 或供应商专用审核参数。网页控制台使用持久平台素材库,并在生成时按最终实际线路自动选择短期签名 URL 或隔离的上游素材副本。

平台当前按 output token 结算视频生成;创建阶段先返回任务状态,最终扣费等任务完成后推进。

官网有但当前平台线路不开放/未确认的参数

官网参数当前平台线路状态
callback_url

官网有回调地址;平台公开异步任务不开放客户回调,统一由平台 worker 轮询、转存和结算,客户查询 /tasks/{taskId}

tools

官网同系列存在联网搜索工具写法;Fast 线路当前未验收,不写入公开支持参数。需要联网搜索时优先使用 doubao-seedance-2-0

Seedance 2.0 Fast 视频生成

curl https://api.llmgate.shop/v1/videos/generations \
  -H "Authorization: Bearer sk-lg-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast",
    "content": [
      {"type": "text", "text": "A short cinematic shot of a coffee cup on a wooden desk"},
      {"type": "image_url", "image_url": {"url": "https://example.com/reference.png"}, "role": "reference_image"}
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p",
    "generate_audio": true,
    "watermark": false
  }'

Seedance 2.0 Fast 首尾帧视频生成

curl https://api.llmgate.shop/v1/videos/generations \
  -H "Authorization: Bearer sk-lg-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast",
    "content": [
      {"type": "text", "text": "Make a smooth cinematic transition from the first image to the second image"},
      {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/first-frame.png"}},
      {"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/last-frame.png"}}
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p",
    "generate_audio": false,
    "watermark": false,
    "return_last_frame": true
  }'

Generation

生成接口接入方式

同步生成接口保持原有 OpenAI-compatible 接入方式:请求直接等待上游返回,不创建公开异步任务,也不受异步队列影响。当前异步视频同步入口(Seedance、HappyHorse)不要求客户解析不同上游的原始任务包装,客户只依赖顶层 idtask_idstatusvideo_urls;拿到上游 task id 时一律先返回 status=running,最终扣费等平台拿到可交付视频后再收口。已知还在生成中的任务遇到一次上游轮询 5xx 仍保持 status=running,不能把临时轮询失败当成最终失败;提交阶段某条异步视频上游 HTTP 200 但没有 task id 也没有视频 URL 会按 UPSTREAM_VIDEO_RESULT_MISSING 记当前线路失败并继续 fallback,所有候选都不可交付时才失败,不会成功扣用户费用。

异步生成接口是在原路径后追加 /async:创建任务返回 HTTP 202,客户端拿 idstatus_url 轮询 /tasks/{taskId}

轮询接口只读平台任务状态,不直接打上游;排队、上游提交、视频轮询、媒体转存和最终结算都由后台 worker 推进。

任务状态包括 queuedsubmittedrunningstoring_mediasucceededfailedexpiredcancelled;内部并发等待原因不会暴露给用户。

Async Example

创建任务并轮询

curl https://api.llmgate.shop/v1/images/generations/async \
  -H "Authorization: Bearer sk-lg-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-lite",
    "prompt": "A clean product photo of a ceramic coffee cup",
    "size": "3K",
    "n": 1
  }'

# Use the returned id, for example task_xxx.
curl https://api.llmgate.shop/v1/images/generations/tasks/task_xxx \
  -H "Authorization: Bearer sk-lg-your-key-here"

创建成功响应

{
  "id": "task_xxx",
  "object": "generation.task",
  "kind": "image_generation",
  "status": "queued",
  "status_url": "/v1/images/generations/tasks/task_xxx",
  "request_id": null,
  "llmgate_image": {
    "requested": {
      "model": "doubao-seedream-5-0-lite",
      "size": "3K",
      "n": 1
    },
    "standard": {
      "model": "doubao-seedream-5-0-lite",
      "size": "3k",
      "image_size_tier": "3K",
      "n": 1
    }
  },
  "result": null,
  "error": null
}

Dashboard

控制台指南

这部分只放网页控制台操作流程,API 接入继续看上面的模型卡片和接口模式。

Dashboard Workflow

控制台参考素材与首尾帧

这部分只说明网页控制台操作,不代表公开视频 API 会代建素材库。控制台会把上传内容转换成 Seedance 需要的参考角色,并按最终实际线路处理素材。

在控制台打开 视频生成,模型选择 doubao-seedance-2-0doubao-seedance-2-0-fast

参考模式切到 首尾帧;这个模式只收图片,不接收参考视频或参考音频。

上传第 1 张图作为首帧;需要尾帧时再上传第 2 张图。只有尾帧、没有首帧的任务不能提交。

网页控制台提供持久 Seedance 素材库:上传一次后可以查询、复用、重命名和删除。原文件保存在平台私有存储,提交视频时平台才按本次最终实际线路选择短期签名 URL 或隔离的上游素材副本。用户不填写 asset://、素材组 ID 或上游素材 ID。

Minimum Setup

API 最小接入参数

请求头使用 Authorization: Bearer sk-lg-your-key-here

Python OpenAI SDK 设置 base_url,Node.js OpenAI SDK 设置 baseURL

聊天补全请求发送到 /chat/completions,完整地址会由 base_url 拼接。

请求模型使用平台模型名,例如 doubao-seed-2-0-pro-260215

调用完成后在控制台调用记录核对 requestId、token、扣费和产品渠道。

Python 示例:只换两行
API 入口https://api.llmgate.shop/v1
from openai import OpenAI

client = OpenAI(
    api_key="sk-lg-your-key-here",
    base_url="https://api.llmgate.shop/v1",
)

response = client.chat.completions.create(
    model="doubao-seed-2-0-pro-260215",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

Video Input

聊天视频输入

`/v1/chat/completions` 支持受控视频理解。公开标准 content part 使用 `type=video`、`uri` 或 `data`、以及 `mime_type`;模型需要在 `/v1/models` 的 `capabilities.video_input` 里显示支持。真实线路不支持视频输入时,平台会继续 fallback 到其它可用候选。

curl https://api.llmgate.shop/v1/chat/completions \
  -H "Authorization: Bearer sk-lg-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-pro",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "请按时间顺序描述这段视频。"},
          {"type": "video", "uri": "https://example.com/video.mp4", "mime_type": "video/mp4"}
        ]
      }
    ]
  }'