1. 原生Gemini格式
OpenAI-Hub接口文档
  • 序言
  • 聊天(Chat)
    • 原生OpenAI格式
      • 创建聊天对话
      • 创建响应 (OpenAI Responses API)
    • 原生Claude格式
      • Claude 聊天
    • 原生Gemini格式
      • Gemini 聊天 (generateContent)
  • 图像(Images)
    • 原生OpenAI格式
      • 创建图像
      • 编辑图像
    • 原生Gemini格式
      • 【开发中】图片生成/编辑(Interactions)
        POST
      • Gemini 图片(Nano Banana)
        POST
    • 通义千问OpenAI格式
      • 编辑图像(qwen-image-edit)
      • 生成图像(qwen-image)
  • 视频(Videos)
    • Sora格式
      • 报错示例
        • Inpaint image must match the requested width and height
      • 创建视频
      • 获取视频任务状态
      • 获取视频内容
    • 可灵格式
      • Kling 图生视频
      • 获取 Kling 图生视频任务状态
      • Kling 文生视频
      • 获取 Kling 文生视频任务状态
    • 即梦格式
      • 即梦视频生成
    • veo格式
      • 创建视频
      • 获取视频任务状态
      • 获取视频内容
    • 创建视频生成任务
    • 获取视频生成任务状态
  • 音频(Audio)
    • 原生OpenAI格式
      • 文本转语音
      • 音频转录
      • 音频翻译
  • 补全(Completions)
    • 原生OpenAI格式
      • 创建文本补全
  • 实时语音(Realtime)
    • 原生OpenAI格式
      • 实时 WebSocket 连接
  • 重排序(Rerank)
    • 文档重排序
      • 文档重排序
  • 审查(Moderations)
    • 原生OpenAI格式
      • 内容审核
  • 嵌入(Embeddings)
    • 原生OpenAI格式
      • 创建文本嵌入
    • 原生Gemini格式
      • Gemini 嵌入(Embeddings)
  • 模型(Models)
    • 列出模型
      • 获取模型列表
      • Gemini 格式获取
  • 插件调用
    • 百度搜索插件 (web_search_baidu)
    • OpenAI 内置联网搜索 (web_search_preview)
    • Claude 内置联网搜索 (web_search_20250305)
    • Gemini 内置联网搜索 (google_search)
  • 未实现(Unimplemented)
    • 微调(Fine-tuning)
      • 列出微调任务 (未实现)
      • 创建微调任务 (未实现)
      • 获取微调任务详情 (未实现)
      • 取消微调任务 (未实现)
      • 获取微调任务事件 (未实现)
    • 文件(Files)
      • 列出文件 (未实现)
      • 上传文件 (未实现)
      • 获取文件信息 (未实现)
      • 删除文件 (未实现)
      • 获取文件内容 (未实现)
  • 数据模型
    • Schemas
      • Blend提交参数
      • ErrorResponse
      • CreateImageRequest
      • CreateImageEditMultipartRequest
      • CreateImageEditWithImageReferencesRequest
      • Describe提交参数
      • Usage
      • ImagesResponse
      • CreateImageEditJsonRequest
      • CreateImageEditWithUploadedFilesRequest
      • Discord账号
      • Model
      • Image
      • ImageUrlInput
      • CreateImageEditCommonRequest
      • Imagine提交参数
      • ModelsResponse
      • ImageUsage
      • FileIdInput
      • ImageInput
      • 任务
      • GeminiModelsResponse
      • ImageTokenDetails
      • ImageBackground
      • 任务查询参数
      • Message
      • ImageEditModel
      • 变化任务提交参数
      • MessageContent
      • ImageCount
      • 变化任务提交参数-simple
      • ToolCall
      • ImageOutputCompression
      • 提交结果
      • Tool
      • ImageOutputFormat
      • ResponseFormat
      • ImagePartialImages
      • ChatCompletionRequest
      • ImageQuality
      • ChatCompletionResponse
      • ImageResponseFormat
      • ChatCompletionStreamResponse
      • ImageEditSize
      • CompletionRequest
      • ImageStream
      • CompletionResponse
      • ImageUser
      • ResponsesRequest
      • ResponsesResponse
      • ResponsesCompactionResponse
      • ResponsesCompactionRequest
      • ResponsesStreamResponse
      • ClaudeRequest
      • ClaudeMessage
      • ClaudeResponse
      • EmbeddingRequest
      • EmbeddingResponse
      • ImageGenerationRequest
      • ImageEditRequest
      • ImageResponse
      • AudioTranscriptionRequest
      • AudioTranslationRequest
      • AudioTranscriptionResponse
      • SpeechRequest
      • RerankRequest
      • RerankResponse
      • ModerationRequest
      • ModerationResponse
      • GeminiRequest
      • GeminiResponse
      • VideoRequest
      • VideoResponse
      • VideoTaskResponse
      • VideoTaskMetadata
      • VideoTaskError
      • OpenAIVideo
      • OpenAIVideoError
      • ApiResponse
      • PageInfo
      • User
      • Channel
      • Token
      • Redemption
      • Log
AI模型接口
图片异步提交后台管理接口
AI模型接口
图片异步提交后台管理接口
  1. 原生Gemini格式

【开发中】图片生成/编辑(Interactions)

开发中
POST
/v1beta/interactions
开发中(2026-07):本站统一出图入口,兼容 Google Gemini 的 interactions 格式。Base URL 为主站。⚠️ 响应字段为临时契约,正在按真实上游返回校准中。
一份 interactions 格式请求进来,按 model 选中的渠道类型自动分流到不同后端,再统一返回:
Gemini / Vertex 渠道 → 直接透传到上游 /v1beta/interactions(保真返回上游 JSON);
OpenAI 及兼容渠道 → 翻译成 /v1/images/generations(有输入图则 /edits),响应组装回 interactions 形态。
能力:文生图、图片编辑(input 里带 type:image 输入图)、流式(stream:true,SSE)。
鉴权:Authorization: Bearer <apikey>。
计费:OpenAI 后端与直连 /v1/images/* 一致;Gemini 透传按模型价(按次/按图)计费;失败不扣。分组差价一致。
日志:每次调用落任务日志(平台 gemini-image / openai-image),结果图转存对象存储、详情可查,不落 base64 到日志行。
aspect_ratio 支持集(各模型不同):如 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 2:3 / 3:2 / 4:5 / 5:4 / 21:9 等;image_size:512px(仅Flash) / 1K / 2K / 4K。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功(临时契约·待实测校准)
application/json
Bodyapplication/json

🟠400参数错误
🟠403余额不足
🔴503模型不可用
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.openai-hub.net/v1beta/interactions' \
--header 'Authorization: Bearer sk-xxx' \
--header 'Authorization: Bearer sk-0ABIEXVjh9****Qckjy' \
--header 'Content-Type: application/json' \
--data '{
    "model": "string",
    "input": [
        {
            "type": "text",
            "text": "string",
            "mime_type": "string",
            "data": "string"
        }
    ],
    "response_format": {
        "type": "image",
        "mime_type": "string",
        "aspect_ratio": "string",
        "image_size": "512px"
    },
    "stream": false
}'
响应示例响应示例
200 - 示例 1
{
    "model": "string",
    "output_image": {
        "data": "string",
        "mime_type": "string"
    },
    "output_text": "string"
}
上一页
编辑图像
下一页
Gemini 图片(Nano Banana)
Built with