使用文档

Appearance

接口文档概览 ​

欢迎使用 ZikL 接口服务。本服务提供多种前沿图像与视频生成模型的统一调用能力，包括 gpt-image 系列、Gemini 生图、xAI Grok 系列（生图 / 视频 / 提示词反推）、千问 Wan 视频生成、Veo 视频生成 以及 可灵视频生成。

每种调用场景均独立列出请求路径、请求参数、调用示例与响应格式。

前置要求

使用接口前，请先在站点注册账号并创建对应的 API 密钥。不同模型可能需要分配不同的模型分组权限，具体操作请参考 创建 API 密钥。

接口服务地址 ​

系统提供两条请求线路，服务与状态完全同步：

线路类型基础地址 (Base URL)说明
优化线路（推荐）https://img.mzfe.de已做网络链路优化，国内及亚太地区建议优先使用
标准线路https://img.zikl.dev标准接口地址，网络良好或海外服务调用时使用

在后续文档的所有示例中， 均代表上述任一地址。

鉴权方式 ​

接口调用统一使用 API 密钥进行鉴权。支持以下两种请求头（Gemini 原生接口两者皆可，OpenAI 兼容接口推荐使用 Bearer）：

1. 标准 Bearer Token（推荐） ​

适用于绝大部分接口（gpt-image、Grok 系列、千问 Wan、Veo、可灵等）：

http
Authorization: Bearer <YOUR_API_KEY>

2. Google API Key 请求头 ​

适用于 Gemini 生图的原生 generateContent 接口：

http
x-goog-api-key: <YOUR_API_KEY>

模型与接口分类 ​

你可以通过侧边栏或点击下方卡片快速直达对应模型的详细调用文档：

🎨 gpt-image

标准 OpenAI 兼容协议。根据用户密钥分组支持 gpt-image-2、gpt-image-2.5、gpt-image-2.5-flare、gpt-image-2.5-sunburst。

查看文档 →

♊ Gemini 生图

基于 Gemini 原生协议，包含香蕉 Pro、香蕉2、Nano Banana 2.1 等模型，支持多比例生成。

查看文档 →

🚀 xAI Grok 系列

涵盖 grok-imagine-image（1K/2K/4K 文生/图生图）、grok-imagine-video（视频生成）及 grok-4.5/4.6/4.7（图片反推提示词）。

查看文档 →

🪐 千问 Wan 视频

官方 OpenAI 格式异步视频生成。提供 Wan 3.0 标准版与 Prime 极速版，支持文生/图生及视频、音频多模态参考。

查看文档 →

🎬 Veo 视频生成

异步生成任务，支持文生视频、单图生视频、首尾帧过渡及多参考图一致性生成。

查看文档 →

⚡ 可灵视频生成

支持 720p 与 1080p 分辨率，提供文生视频、图生视频、首尾帧以及独特的动作控制功能。

查看文档 →

异步任务通用机制 ​

对于视频生成接口（Grok 视频、千问 Wan、Veo、可灵），均采用标准异步任务处理模式：

  1. 提交任务：向 POST /v1/videos 提交参数，成功后立即返回任务 ID（如 {"id": "xxxx", "status": "queued"}）。
  2. 轮询状态：客户端每隔 5 ~ 15 秒向 GET /v1/videos/{id} 发起查询。
  3. 完成取片：状态流转通常为 queued（已排队） → in_progress（生成中） → completed（已完成）。当 status 为 completed 时，从返回的 metadata.url 提取视频直链或访问内容端点下载。
  4. 失败处理：若 status 为 failed，表示生成失败，系统不消耗额度。

一键复制文档给 AI 助手 ​

如果你需要让 ChatGPT、Claude 或 Cursor 辅助你编写生图/视频代码或排查调用问题，可以将下方的全量接口规约复制并发送给 AI：

点击展开查看全量接口规约（适合直接喂给 AI）
markdown
# ZikL 生图与视频接口完整规约

服务基础地址：
- 优化线路：https://img.mzfe.de
- 标准线路：https://img.zikl.dev
鉴权：Header "Authorization: Bearer <API_KEY>" 或 "x-goog-api-key: <API_KEY>"（Gemini接口）

1. gpt-image 系列
- 模型选择（根据 API 密钥分组权限而定）：
  - gpt-image-2 (基础稳定版)
  - gpt-image-2.5 (2.5升级版)
  - gpt-image-2.5-flare (Flare风格版，1K分组中统一请求 gpt-image-2.5)
  - gpt-image-2.5-sunburst (Sunburst通透版，1K分组中统一请求 gpt-image-2.5)
- 文生图：POST /v1/images/generations (JSON)
  参数：model(上述模型之一, 必填), prompt(必填), size("1024x1536"等，可选), quality("high"/"medium", 可选), n=1(必填), response_format("url"/"b64_json", 可选)
- 图生图：POST /v1/images/edits (multipart/form-data)
  参数：model, image/image[](文件, 可重复), prompt(必填), size, quality, n=1, response_format

2. Gemini 生图 (Gemini 原生 generateContent)
- 模型：gemini-3-pro-image-preview (香蕉 Pro), gemini-3.1-flash-image-preview (香蕉2), gemini-nano-banana-2.1 (Nano Banana 2.1), omni-flash
- 接口：POST /v1beta/models/{model}:generateContent (JSON)
- 请求头：x-goog-api-key 或 Authorization: Bearer
- 参数：
  - contents[].role: "user"
  - contents[].parts: 包含文字 text，或 inline_data {mime_type, data}，或 file_data {mime_type, file_uri}
  - generationConfig.responseModalities: ["IMAGE"] (返回 inline_data base64) 或 ["TEXT"] (返回 file_data url) 或 ["IMAGE","TEXT"]
  - generationConfig.imageConfig.aspectRatio: "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "5:4", "4:5", "21:9"（香蕉2额外支持 8:1, 4:1, 1:4, 1:8）
  - generationConfig.imageConfig.imageSize: "1K", "2K", "4K"

3. xAI Grok 系列 (生图 / 视频 / 提示词反推，需 grok 相关分组权限)
- Grok 图像生成：
  - 模型：
    - grok-imagine-image (支持文生图与图生图 1K/2K/4K，兼容 openai 与 openai-response)
    - grok-imagine-image-2.0 (2.0版，支持文生图与图生图 1K/2K/4K，兼容 openai 与 openai-response)
    - grok-imagine-image-lite (轻量版，仅支持文生图，不支持图生图)
  - 文生图：POST /v1/images/generations (JSON) -> model, prompt, size("1K"/"2K"/"4K"或"1024x1024"), n=1, response_format("url"/"b64_json")
  - 图生图：POST /v1/images/edits (multipart/form-data，仅限 grok-imagine-image 与 grok-imagine-image-2.0) -> model, image/image[], prompt, size("1K"/"2K"/"4K"), n=1, response_format
- Grok 视频生成 (异步任务接口)：
  - 模型：grok-imagine-video (支持 480p/720p，支持参考视频), grok-imagine-video-1.5 (支持 480p/720p/1080p，最长15s)
  - 提交：POST /v1/videos (JSON) -> model, prompt, duration/seconds(如 8), aspect_ratio("16:9"/"9:16"/"1:1"), image_url(可选首帧图), reference_video(可选参考视频，仅 grok-imagine-video)
  - 轮询：GET /v1/videos/{id}
- Grok 视觉反推提示词与对话：
  - 模型：grok-4.5, grok-4.6, grok-4.7
  - 接口：POST /v1/chat/completions (JSON) -> model, messages(支持 content 数组传入 text 与 image_url 进行识图反推提示词), stream

4. 千问 Wan 视频生成 (官方 OpenAI 格式异步接口)
- 提交：POST /v1/videos (JSON)
- 轮询：GET /v1/videos/{id}
- 下载：GET /v1/videos/{id}/content 或从 metadata.url 提取签名直链
- 模型列表（分辨率后缀决定输出）：
  - 标准版：wan3.0-video-480p, wan3.0-video-720p, wan3.0-video-1080p (支持图/音/视频参考，视频计费)
  - Prime 极速版：wan3.0-video-prime-480p, wan3.0-video-prime-720p, wan3.0-video-prime-1080p
- 参数规范：
  - 基础字段：model(必填), prompt(必填, 可用"图1""视频1""音频1"引用), seconds(建议字符串如"10", 兼容duration), aspect_ratio("16:9"/"9:16"/"1:1"/"adaptive", 兼容ratio), size("480P"/"720P"/"1080P", 兼容resolution，会被模型后缀覆盖)
  - 图片/首尾帧：reference_images: [{url: "https://...", role?: "reference_image"|"first_frame"|"last_frame"}] (最多10张)
  - 视频参考：reference_videos: [{url: "https://...", duration?: 5}] 或 ["https://..."]（服务端自动读取时长并计费）
  - 音频参考：reference_audios: [{url: "https://..."}] (参与生成与卡点，不计秒数)

5. Veo 视频生成 (异步接口)
- 提交：POST /v1/videos (JSON)
- 轮询：GET /v1/videos/{id}
- 模型：veo-3.1-fast (快速档), veo-3.1-lite (轻量档), veo-3.1-quality (画质档)（兼容 veo-3.1-fast-generate-preview, veo-3.1-generate-preview, veo-3.1-generate-preview-ref）
- 场景：
  - 文生视频：prompt(必填), duration(4/6/8), aspect_ratio("16:9"/"9:16"), generate_audio(bool)
  - 单图生视频：prompt, image_url(公网直链/dataURL/裸base64), duration(4/6/8), aspect_ratio, generate_audio
  - 首尾帧视频：prompt, image_urls(长度2数组，第1张首帧第2张尾帧), duration, aspect_ratio, generate_audio
  - 多参考图视频：model固定为 veo-3.1-generate-preview-ref, prompt, image_urls(参考图数组), duration固定为8, aspect_ratio固定为"16:9"

6. 可灵视频生成 (异步接口)
- 提交：POST /v1/videos (JSON)
- 轮询：GET /v1/videos/{id}
- 模型：kling-3.0-omni-720p (720p), kling-3.0-omni-1080p (1080p)
- 参数：
  - duration: 5 / 10 / 15 秒
  - aspect_ratio: "16:9" (默认) 或 "9:16"
  - generate_audio: bool (默认 true)
- 场景：
  - 文生视频：model, prompt, duration, aspect_ratio, generate_audio
  - 图生视频：model, prompt, image_url, duration, aspect_ratio, generate_audio
  - 首尾帧视频：model, prompt, image_urls(数组2张), duration, aspect_ratio, generate_audio
  - 动作控制：model, prompt, image_url(角色外观图), reference_video(动作源视频公网直链URL), duration, aspect_ratio, generate_audio

ZikL 生图站使用指南与接口文档

Copyright © 2026 ZikL生图站