跳到主要内容

API 文档

欢迎使用 4oImageApi.io API 文档。本指南将帮助您了解如何有效地使用我们的 API 服务。

API 服务概览​

我们目前提供以下 API 服务：

  1. 4o Image - 使用先进的 GPT-4o 多模态模型创建细节丰富、创意十足的 AI 图像

    • 文本到图像生成
    • 基于最多5张参考图像的创作
    • 可自定义图像尺寸比例(1:1, 3:2, 2:3)
    • 异步处理与回调通知
    • 任务状态跟踪和进度监控

  2. 账户管理 - 监控和管理您的账户信息、积分余额、使用配额和 API 访问设置

    • 积分余额查询
    • 使用记录跟踪
    • API 访问管理

基础信息​

  • API 服务器: https://4oimageapiio.erweima.ai
  • API 版本: 1.0.0
  • 技术支持: [email protected]

认证​

所有 API 都需要使用 Bearer Token 认证：

Authorization: Bearer YOUR_API_KEY

获取您的 API Key：

  1. 访问 API Key 管理页面
  2. 生成您的专属 API Key
  3. 在所有 API 请求中使用它

重要提示：

  • 妥善保管您的 API Key
  • 切勿与他人分享您的 API Key
  • 如果怀疑泄露，请立即重置

API 服务​

4o Image 生成​

4o Image API 提供 AI 驱动的图像生成能力：

  • 通过 /api/v1/gpt4o-image/generate 创建 AI 生成的图像
  • 支持基于提示词和基于图像的创作方式
  • 可引用最多5张图像作为创作灵感
  • 提供三种宽高比选择(1:1, 3:2, 2:3)
  • 通过 /api/v1/gpt4o-image/record-info 查询生成任务详情

主要特点：

  • 生成的图像存储期限为 14 天
  • 异步处理，支持回调通知
  • 多种生成状态用于跟踪进度：
    • GENERATING: 生成进行中
    • SUCCESS: 生成成功
    • CREATE_TASK_FAILED: 任务创建失败
    • GENERATE_FAILED: 生成失败
  • 灵活的创作方式，支持从文本或参考图像创建
  • 每个任务的最大查询频率为每秒3次

了解更多关于 4o Image API →

错误处理​

我们的 API 使用标准的 HTTP 状态码和详细的错误信息：

状态码说明
200成功 - 请求已成功处理
401未授权 - 认证凭证缺失或无效
402积分不足 - 账户没有足够的积分执行操作
404未找到 - 请求的资源或端点不存在
422验证错误 - 请求参数未通过验证检查
429请求限制 - 此资源的请求限制已超出
455服务不可用 - 系统当前正在维护
500服务器错误 - 处理请求时发生意外错误
505功能已禁用 - 请求的功能当前已禁用

最佳实践​

  1. 认证

    • 安全存储您的 API Key
    • 定期轮换密钥以增强安全性
    • 为认证失败实现适当的错误处理

  2. 4o Image 生成

    • 提供清晰、描述性的提示词以获得更好的图像生成效果
    • 使用参考图像时，考虑使用多张以获得更多创作控制
    • 根据应用需求指定适当的宽高比
    • 为不同的生成状态实现适当的错误处理
    • 注意每个任务的查询频率限制

  3. 账户管理

    • 定期监控积分使用情况
    • 为积分耗尽实现备用机制
    • 在适当的地方考虑缓存响应

需要帮助？​

如果您遇到任何问题或有疑问，请通过以下方式联系我们：

语言支持

本文档提供英文和中文版本。您可以使用导航栏中的语言选择器切换语言。