1. 通用接口
心流API 接口文档
  • 引言
  • 在线调试说明
  • 发出请求
  • 中转站基本介绍
    • API 快速开始指南
    • 联系客服
    • 代理接口调用地址
    • API Key 额度查询服务
  • 通用接口
    • 文本通用接口
      POST
    • 图片通用接口
      POST
    • 视频通用接口
      POST
  • 图像模型
    • GPT Image 2(OpenAI 生图)
      • GPT Image 2 文生图
      • GPT Image 2 图生图(编辑)
    • Gemini Nano Banana(Google 生图)
      • Gemini Nano Banana 图片生成
      • 文本通用接口(Gemini 原生格式)
    • Grok Imagine(xAI 生图)
      • Grok 文生图(同步)
  • 视频模型
    • Grok Imagine 1.0 视频
      • Grok Imagine 1.0 视频生成
    • Grok Imagine 1.5 Video Preview(xAI 文生/图生视频)
      • Grok Imagine Video Preview 视频生成
      • Grok Imagine Video 1.5 Preview 视频生成
    • Grok Imagine 1.5 720p(xAI 图生视频)
      • Grok Imagine 1.5 Super 视频生成
    • Veo(Google 视频生成)
      • Veo 视频生成
      • Veo 视频延长(Extend)
    • Omni 系列(omni_flash · 文生 / 图生 / 视频修改)
      • Omni 视频生成(omni_flash-10s)
    • Grok Video 3 系列(xAI 新族)
      • Grok Video 3 视频生成
    • Sora 2(OpenAI 视频生成)
      • Sora 2 视频生成
    • Grok Video 10s
      • Grok Video 6s/10s/12s 视频生成
    • HappyHorse 1.0 系列(阿里淘天)
      • HappyHorse 1.0 视频生成
    • 豆包 Seedance 2.0 Fast
      • 豆包 Seedance 2.0 Fast 视频生成
    • 视频任务查询(共用)
      GET
    • 视频内容下载(共用)
      GET
  • 系统 API(客户可用)
    • 拉取模型列表
    • 查询当前令牌用量
    • 系统状态 / 公告
  • 各种插件/软件使用教程
    • Codex 配置教程
    • OpenClaw Clawdbot 自定义中转站配置教程
    • N8N 工作流使用中转API 教程
    • opencode 配置教程
    • Gemini CLI 中转站配置使用教程
    • Claude Code 安装使用教程
    • CherryStudio调用cluade MCP
    • Cherry Studio配置教程
    • Cherry Studio配置 banana pro 4K和分辨率教程
    • CherryStudio配置o4推理级别
    • 扣子工作流简单配置从输入到获取url
    • dify添加模型
    • cline 配置教程
    • aider 配置教程
    • Cursor 配置教程
    • lobechat 设置教程
    • ChatBox(推荐使用)
    • 开源gpt_academic
    • nextchat 设置教程
    • zotero gpt 配置方法
    • CLAUDE DEV 配置教程
    • 沉浸式翻译 设置gpt翻译
    • 浏览器插件ChatGPT Sidebar
    • chatgpt-on-wechat 配置教程
    • chatgpt GPT Academic 学术优化配置gpt教程
    • RikkaHub 配置教程
    • coze 工作流使用中转API 教程
    • n8n 工作流获取本地图片生成视频例子
    • OpenClaw 最新版本 自定义中转站配置教程
    • OpenClaw配合CC switch自定义中转站配置教程
  • 帮助中心
    • AI返回字段: 思考相关
    • HTTP状态码及其含义
    • 自建图床API
  • Python配置方式
    • python 使用 语音转文本
    • python 使用文本转语音
    • python 使用Embeddings 向量化
    • python 调用DALL·E
    • python简单调用 openai function-calling demo
    • python 简单langchain 调用openai demo
    • python llama_index 配置
    • Python基础对话
    • Python使用gpt-4o识别图片-本地图片
    • Python使用gpt-4o识别图片
    • Python使用Claude识别图片
    • python 库流式输出
    • gpt realtime模型调用
    • python request 请求 流式输出demo
    • python 使用gpt-image-1 创建编辑图片
    • python openai官方库(使用AutoGPT,langchain等)
    • python 连续对话
  • php配置方式
    • php使用图片编辑demo
  • nodejs 配置方式
    • nodejs 基础对话
  1. 通用接口

图片通用接口

POST
/v1/images/generations

图片生成#

兼容 OpenAI Images 协议。
本接口 gpt-image-2 返回 OSS URL 链接(data[].url),不是 base64。OSS URL 1~24 小时内有效。

接入地址#

线路Base URL说明
国内加速(推荐)https://cdn.wusag.com走国内 CDN 节点
海外直连https://api.xinliu.one海外服务器或加速节点异常时使用
两个地址共用同一账户和 Key。

请求#

方法:POST {Base URL}/v1/images/generations
Header:
Authorization: Bearer 你的令牌
Content-Type: application/json

参数#

字段类型必填说明
modelstring是见下方"可用模型"
promptstring是文本提示词
nint否生成数量,默认 1
sizestring否1024x1024 1024x1536 1536x1024 auto 等
qualitystring否low / medium / high / auto(gpt-image-2 系列)
response_formatstring否url(默认)/ b64_json
stylestring否vivid / natural(DALL·E 3 专属)

可用模型#

完整列表请调 GET {Base URL}/v1/models,过滤 model_type=图像。常用:
model厂商备注
gpt-image-2 / gpt-image-2-proOpenAI旗舰,返回 OSS URL
gpt-image-2-2026-04-21OpenAI 官方版本
grok-imagine-image / grok-imagine-image-proxAI
grok-4.1-image / grok-4.2-imagexAI
gemini-2.5-flash-image-previewGoogleNano Banana
gemini-3.1-flash-image-previewGoogleNano Banana 2
gemini-3-pro-image-previewGoogleNano Banana Pro
doubao-seedream-4-0-250828字节即梦 4.0
doubao-seedream-4-5-251128字节即梦 4.5
doubao-seedream-5-0-260128字节即梦 5.0

返回示例#

{
  "data": [{
    "url": "https://files.example.com/img/<uuid>.png",
    "b64_json": "",
    "revised_prompt": ""
  }],
  "created": 1778069104
}

异步任务模型不走本接口#

Midjourney、可灵、Runway、Sora 等异步生图任务用各自专属接口或 POST /v1/videos(部分图像模型如 Nano Banana 在心流走 /v1/videos 异步路径)。

请求示例#

错误码#

400 参数错误
401 令牌无效或未提供
402 余额不足
404 模型不存在或未开通
429 速率限制
500 服务端错误

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数

Body 参数application/json

示例
{
    "model": "string",
    "prompt": "string",
    "size": "string",
    "n": 0,
    "quality": "string"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/v1/images/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "string",
    "prompt": "string",
    "size": "string",
    "n": 0,
    "quality": "string"
}'

返回响应

🟢200成功
application/json
成功
Bodyapplication/json

示例
{}
修改于 2026-05-09 10:28:29
上一页
文本通用接口
下一页
视频通用接口
Built with