返回首页接入区

使用文档:API 接入

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

API 当前入口

http://124.174.86.196/v1

域名上线后

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

当前使用 http://124.174.86.196/v1,域名上线后切到 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。
POST/v1/videos/generationsBearer sk-lg-*视频生成同步入口,JSON 请求;上游可能直接返回视频结果,也可能返回上游 task id。
GET/v1/videos/generations/{task_id}Bearer sk-lg-*查询同步视频入口返回的上游视频任务;异步任务不要用这个接口,改用 /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 请求体。
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 请求体。

OpenAI GPT Image2

gpt-image-2 / gpt-image-2-llm
/v1/images/generations/v1/images/generations/async

公开生图模型,适合高质量文生图、参考图生成和编辑式生成。当前平台低价和标准渠道按张固定计费。

Parameter说明
model

必填,传 gpt-image-2gpt-image-2-llmgpt-image-2-llm 是产品侧别名,能力和路由口径与 gpt-image-2 保持一致。

prompt

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

size

可选。官方标准是 auto1024x10241536x10241024x1536;平台额外兼容 1K/2K/4K 档位、自定义 WIDTHxHEIGHT 像素尺寸和 16:91:1 等比例写法。兼容写法会先归一成平台第一层标准尺寸,再按命中线路适配最终上游参数;同步 generations、异步 generations 和 direct edits 使用同一套 Image2 尺寸口径。

resolution

可选,平台兼容字段。支持 1k2k4k,优先级高于从 size 推断出的档位。

quality

可选,支持 lowmediumhighauto

image / images / reference_images

可选参考图,支持公网图片 URL 或 data URL。OpenAI 官方 Image API 的参考图写法是 /v1/images/edits multipart 的 image 文件字段;reference_images 是平台 JSON 兼容别名,平台会转成官方 edits 请求,不会原样透传给上游 /v1/images/generations

n

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

response_format

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

stream

可选,传 true 时返回图片流式事件;平台会透传或适配 image_generation.partial_image / image_generation.completed,图片内容以 b64_jsonurl 交付。

无参考图时,平台按文生图请求处理;带 imageimagesreference_images 时,平台按 OpenAI 官方参考图口径改走 edits 请求。

Image2 的对外标准参数以 GPT 官方口径为准:公开模型仍是 gpt-image-2 / gpt-image-2-llm,不会把内部上游专用模型 ID 暴露给用户。size 接受官方参考尺寸 auto1024x10241536x10241024x1536,也接受符合 Image2 约束的像素尺寸,例如 3840x216016:99:161K/2K/4Kresolution 是平台兼容输入,会先归一成第一层标准像素尺寸再进路由。

通过 resolution1K/2K/4K、比例或自定义像素触发归一且未传 quality 时,平台会按档位补默认质量;只传官方参考尺寸且不传 quality 时不强行补。

参考图 URL 必须是公网可访问的 httphttps 图片;内网、本机和私有地址会被拒绝。data URL 支持直接内联小图。

响应会返回 llmgate_image,包含用户提交参数和平台第一层标准参数;真实上游线路和内部 fallback 不在公开使用文档里展示。

GPT Image2 带参考图生成

curl http://124.174.86.196/v1/images/generations \
  -H "Authorization: Bearer sk-lg-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Create a clean product photo using the cup in the reference image",
    "size": "16:9",
    "resolution": "4k",
    "quality": "high",
    "reference_images": ["https://example.com/reference-cup.png"],
    "n": 1,
    "response_format": "url"
  }'

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 支持值

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

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

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

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

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

官网有流式相关能力;当前 Seedream 公开线路按同步结果或异步任务推进,不承诺图片流式响应。Image2 的 stream=true 在 Image2 参数表单独开放。

sequential_image_generation

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

sequential_image_generation_options

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

tools

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

optimize_prompt_options

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

Seedream 5.0 Lite 图片生成

curl http://124.174.86.196/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 支持值

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

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

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

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

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

官网有流式相关能力;当前 Seedream 公开线路按同步结果或异步任务推进,不承诺图片流式响应。Image2 的 stream=true 在 Image2 参数表单独开放。

sequential_image_generation

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

sequential_image_generation_options

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

tools

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

optimize_prompt_options

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

Seedream 4.5 图片生成

curl http://124.174.86.196/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 内容块。

duration

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

ratio

可选,画面比例,例如 16:99:161:1

resolution

可选,分辨率,例如 720p1080p;实际可用值按当前模型和线路能力执行。

generate_audio

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

watermark

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

seed

可选,随机种子,整数。

return_last_frame

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

tools

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

首尾帧用 role: "first_frame" / role: "last_frame";普通参考图用 role: "reference_image"

同步入口可能直接返回视频,也可能返回上游任务;平台异步入口会由 worker 负责轮询、转存和结算。

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

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

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

Seedance 2.0 视频生成

curl http://124.174.86.196/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
  }'

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 内容块。

duration

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

ratio

可选,画面比例,例如 16:99:161:1

resolution

可选,分辨率,例如 720p1080p;实际可用值按当前模型和线路能力执行。

generate_audio

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

watermark

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

seed

可选,随机种子,整数。

return_last_frame

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

Fast 模型不要照搬图片模型的 prompt + image 写法;视频请求用 content 数组。

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

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

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

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

tools

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

Seedance 2.0 Fast 视频生成

curl http://124.174.86.196/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
  }'

Generation

生成接口接入方式

同步生成接口保持原有 OpenAI-compatible 接入方式:请求直接等待上游返回,不创建平台异步任务,也不受异步队列影响。

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

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

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

Async Example

创建任务并轮询

curl http://124.174.86.196/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 http://124.174.86.196/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
}

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 示例:只换两行
当前测试入口http://124.174.86.196/v1
域名上线后https://api.llmgate.shop/v1
from openai import OpenAI

client = OpenAI(
    api_key="sk-lg-your-key-here",
    base_url="http://124.174.86.196/v1",
)

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

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