OhMyGPT API
中文
  • 中文
  • English
  • 日本語
OhMyGPT
OhMyGPT
中文
  • 中文
  • English
  • 日本語
中文
  • 中文
  • English
  • 日本語
  1. 图像生成
  • 本站介绍
  • 更新日志
  • 推广计划奖励使用说明
  • OpenClaw配置文档
  • OpenAI
    • Responses
      • 创建 model response
      • 获取 model response
      • 删除 model response
      • 取消响应
      • 列出 input items
    • Conversations
      • 创建 conversation
      • 检索 conversation
      • 更新 conversation
      • 删除 conversation
      • 创建 items
      • 列出 items
      • 检索 item
      • 删除 item
    • Chat.Completions API
      POST
    • TTS文本转语音
      POST
    • Embeddings
      POST
    • 图像生成
      POST
    • 图像编辑
      POST
  • Claude
    • batches
      • 创建消息批次
      • 检索消息批次
      • 检索消息批次结果
      • 列出消息批次
      • 取消消息批次
      • 删除消息批次
    • Claude Code专用接口
      • Claude Code专用接口 (Messages原生API)
      • Claude Code API (Chat.Completions 兼容API)
    • Anthropic 原生 Completions 企业商用 API
      POST
    • Anthropic 原生 Messages API
      POST
    • Anthropic 原生 Messages Token Count API
      POST
  • 图像生成
    • OpenAI Images WebHook/Polling支持
    • 其它
      • ND图像生成 API
    • Flux
      • Flux Schnell 图像生成
      • Flux Dev 图像生成
      • Flux Pro 图像生成
      • Flux Pro 1.1 图像生成
      • Flux 1.1 Pro Ultura 图像生成
  • 覆写规则
    • 创建规则
      POST
    • 更新规则
      POST
    • 删除规则
      POST
    • 获取规则
      POST
    • 列出规则
      POST
    • 批量启用/禁用
      POST
    • 复制规则
      POST
    • 测试规则
      POST
    • 获取统计信息
      POST
    • 获取限制配置
      POST
    • 检查规则名
      POST
    • 批量删除
      POST
    • 导出规则
      POST
    • 导入规则
      POST
  • Store
    • 列出聊天完成项
    • 获取聊天完成
    • 删除聊天完成
  • OAuth
    • 开放OAuth API介绍
    • 用户授权页
    • Code展示页
    • 申请access_token
    • 读取用户基本信息
    • 读取用户余额信息
    • 收取用户费用
    • 为用户创建一个Stripe Checkout充值订单
    • 为用户创建一个Stripe Invoice充值订单
    • 调用其它开放API
    • 通过OAuth Token读取用户管理Token
    • 通过OAuth Token更新用户管理Token
  • 存储服务
    • 文件存储服务
    • 文件上传
    • 文件信息更新
    • 删除文件
    • 用户查询 (分页)
    • 用户元数据查询 (by fileUinqueIds)
    • 文件下载接口(Public公开文件下载)
    • 文件下载接口(Private私有文件下载)
    • 公开文件元数据获取
  • API KEY 管理
    • 创建新的API Key
    • 修改API Key信息
    • 查询用户所有的API Key
    • 删除指定API Key
    • 查询用户会员到期日期接口
    • 用户余额查询接口
    • 查询当前模型倍率接口
  • 其它
    • 搜索
      • Google Custom Search API
      • Google Search By Serper
    • Azure
      • Azure 文本转语音
      • Azure 获取TTS 语音列表
    • [Beta] OhMyGPT Socket.IO 统一API端点
    • Gemini 3 Pro Image Preview API
  • 归档文档
    • 自助开票系统使用文档
    • Telegram Bot使用文档
    • 自建Cloudflare Worker反代教程
    • Claude Code转发服务
    • CodeX转发服务
    • 新版网站介绍
  • 模型列表
    GET
  • 数据模型
    • Chat
      • ChatSession
      • ChatMessage
      • ChatGPTParams
      • UserPrompts
      • OnlinePrompts
    • User
      • User
      • UserLog
      • UserToken-D
    • Pay
      • UserOrder
      • UserBill
    • System
      • OpenAIKey
      • SystemOpenAIKey
      • Settings
      • SmtpSettings
      • MailDto
    • Draw
      • AIImages
      • MjImagineQueryResult
    • InteralDataModelDefine
    • Schemas
      • Scope
      • ApiType
      • RuleCondition
      • ActionType
      • RuleAction
      • ParameterOverrideRule
      • CreateRuleRequest
      • CreateRuleResponse
      • UpdateRuleRequest
      • IdRequest
      • ToggleRulesRequest
      • DuplicateRuleRequest
      • ListRulesRequest
      • RulesArray
      • ListRulesResponse
      • StatsResponse
      • RestrictionsResponse
      • CheckRuleNameRequest
      • CheckRuleNameResponse
      • BatchDeleteRequest
      • ExportRulesResponse
      • ImportRulesRequest
      • ImportRulesResponse
      • TestRulesRequest
      • AppliedRule
      • TestRulesResponse
      • GenericOk
      • GenericError
    • Payload
    • PubResponse
  1. 图像生成

OpenAI Images WebHook/Polling支持

简介#

由于OpenAI GPT Image 2模型推理速度不可控,单图像推理速度非常慢,HTTP超时断开,从而导致用户的程序可能无法正常收到响应内容。
因此增加了WebHook和Polling模式方便开发者对接防止超时。

使用方法#

对于OpenAI Image Generations和Edits接口,请求体的Body增加如下可选参数:
- omg.async_method: "webhook" | "pulling"
- omg.webhook_url: "https://example.com/webhook/your_sec_path/target" # Optional 当body.omg.async_method = "webhook"时,必须是一个合法的http或https URL,请求体就是响应体,请求内容就是OpenAI生成的响应内容。

WebHook模式#

当body.omg.async_method === "webhook"并且设置了body.omg.webhook_url时,请求会直接返回然后在后台继续执行,请求执行完毕之后会将OpenAI的响应内容Post到目标webhook端点。
WebHook调试方法:
使用这个网站:https://webhook.site/
示例请求:
{
    "model": "gpt-image-2",
    "prompt": "科比表情包",
    "n": 1,
    "size": "1024x1024",
    "omg": {
        "async_method": "webhook",
        "webhook_url": "https://webhook.site/e928b39d-93bd-4dde-a862-c20d8fe9e474"
    }
}
示例响应:
{
    "object": "omg.async_task",
    "async_method": "webhook",
    "status": "pending",
    "webhook_url": "https://webhook.site/e928b39d-93bd-4dde-a862-c20d8fe9e474"
}
WebHook收到成功示例:
image.png
image.png
{
    "created": 1783588333,
    "background": "opaque",
    "data": [
        {
            "b64_json": "iVxxx"
        }
    ],
    "output_format": "png",
    "quality": "low",
    "size": "1024x1024",
    "usage": {
        "input_tokens": 11,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 11
        },
        "output_tokens": 196,
        "output_tokens_details": {
            "image_tokens": 196,
            "text_tokens": 0
        },
        "total_tokens": 207
    }
}
WebHook收到的报错示例:
{
  "error": {
    "message": "Invalid size '1920x1080'. Width and height must both be divisible by 16.",
    "type": "image_generation_user_error",
    "param": "size",
    "code": "invalid_value"
  }
}

Polling模式#

当body.omg.async_method === "pulling"时,请求也会直接返回,然后给一个TaskID,使用此TaskID轮询指定接口即可获得响应状态以及最终结果:
示例请求
{
    "model": "gpt-image-2",
    "prompt": "原神x英伟达联名海报",
    "n": 1,
    "size": "auto",
    "omg": {
        "async_method": "pulling"
    }
}
响应结果:
任务已提交:
{
    "object": "omg.async_task",
    "async_method": "pulling",
    "status": "pending",
    "task_id": "JFAhhlUVOeAOc9AR",
    "ttl_seconds": 43200,
    "pull_url": "/api/v1/ai/openai/v1/images/generations/omg-task-pull?taskId=JFAhhlUVOeAOc9AR"
}
执行中:
GET: https://apic1.ohmycdn.com/api/v1/ai/openai/v1/images/generations/omg-task-pull?taskId=JFAhhlUVOeAOc9AR
{
    "status": "pending"
}
执行完毕:
GET: https://apic1.ohmycdn.com/api/v1/ai/openai/v1/images/generations/omg-task-pull?taskId=JFAhhlUVOeAOc9AR
image.png
image.png
{
    "created": 1783588908,
    "background": "opaque",
    "data": [
        {
            "b64_json": "iVBORwII="
        }
    ],
    "output_format": "png",
    "quality": "medium",
    "size": "1086x1448",
    "usage": {
        "input_tokens": 16,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 16
        },
        "output_tokens": 686,
        "output_tokens_details": {
            "image_tokens": 686,
            "text_tokens": 0
        },
        "total_tokens": 702
    }
}

普通模式#

标准API行为
输入:
{
    "model": "gpt-image-2",
    "prompt": "三井住友银行x崩坏三联名海报",
    "n": 1,
    "size": "auto"
}
输出:
image.png
{
    "created": 1783589191,
    "background": "opaque",
    "data": [
        {
            "b64_json": "iVBORTkSuQmCC"
        }
    ],
    "output_format": "png",
    "quality": "medium",
    "size": "1086x1448",
    "usage": {
        "input_tokens": 20,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 20
        },
        "output_tokens": 686,
        "output_tokens_details": {
            "image_tokens": 686,
            "text_tokens": 0
        },
        "total_tokens": 706
    }
}
修改于 2026-07-09 09:28:51
上一页
Anthropic 原生 Messages Token Count API
下一页
ND图像生成 API
Built with