Tạo ảnh GPT-Image-2

gpt-image-2 hỗ trợ tạo ảnh và chỉnh sửa ảnh tham chiếu cho ảnh sản phẩm, bản nháp áp phích, minh họa, tư liệu mạng xã hội, hình ảnh độ phân giải cao, chuyển phong cách và kết hợp nhiều ảnh tham chiếu.

POST https://api.apihop.ai/openai/v1/images/generations

Xác thực

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Bắt đầu nhanh

{
  "model": "gpt-image-2",
  "prompt": "A minimal black wireless earbud product poster on a white background, clean studio lighting, no text",
  "n": 1,
  "size": "2048x1152",
  "resolution": "2k",
  "quality": "low"
}

Phạm vi so sánh giá

Các cấp ảnh 1K / 2K / 4K được API Hop công bố là *giá bán của API Hop*, không phải giá OpenAI chính thức cố định theo ảnh. Tài liệu giá OpenAI mô tả phí token ảnh/văn bản và cấp xử lý; chi phí thực tế phụ thuộc kích thước, chất lượng, đầu vào tham chiếu và đầu ra. So sánh hai bên chỉ vì đều nhắc 1k hoặc 2k không phải tính chiết khấu trên cùng cơ sở.

Để tránh tuyên bố tiết kiệm không có căn cứ, tham chiếu USD per image tổng hợp nhà cung cấp cũ và nhãn giảm giá được chủ động ẩn cho GPT Image 2. Giá API Hop vẫn hiển thị và hợp đồng tính phí không đổi. Để so sánh có căn cứ sau này, ghi chính xác mô hình, điểm cuối, chất lượng ảnh, kích thước, điều kiện đầu vào, URL nguồn chính thức và ngày xác minh tham chiếu. Kiểm tra giá hiệu lực của tài khoản trước khi gọi có phí.

Thân yêu cầu

Ảnh tham chiếu và chỉnh sửa

Chỉnh sửa ảnh tham chiếu dùng cùng điểm cuối JSON. Thêm image_urls và mô tả nội dung cần giữ, cần đổi trong prompt:

{
  "model": "gpt-image-2",
  "prompt": "Keep the product unchanged, replace the background with a dark blue studio, and add soft rim lighting",
  "image_urls": [
    "https://example.com/product.png"
  ],
  "size": "1:1",
  "resolution": "2k"
}

Nhiều ảnh tham chiếu có thể cung cấp chủ thể, bố cục hoặc phong cách hình ảnh:

{
  "model": "gpt-image-2",
  "prompt": "Use the product from the first image and the composition from the second image to create a clean ecommerce hero image",
  "image_urls": [
    "https://example.com/product.png",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ],
  "size": "4:3",
  "resolution": "2k"
}

Ranh giới hợp đồng công khai hiện tại:

• Hỗ trợ chỉnh sửa toàn ảnh, chuyển phong cách và kết hợp nhiều ảnh tham chiếu qua image_urls.
• Không có tuyến POST https://api.apihop.ai/openai/v1/images/edits riêng.
• Không chấp nhận tải lên multipart/form-data. Chuyển ảnh cục bộ sang data URI base64 hoặc tải lên URL truy cập được trước.
• Không hỗ trợ vẽ bù bằng mặt nạ. Gửi mask, mask_url hoặc maskUrl trả 400 trước khi giữ chỗ.

Ví dụ yêu cầu

Ảnh sản phẩm 1:1

{
  "model": "gpt-image-2",
  "prompt": "A transparent glass cup on a light gray background, commercial product photography, soft shadow, no text",
  "n": 1,
  "size": "1024x1024",
  "resolution": "1k",
  "quality": "low",
  "output_format": "png"
}

Áp phích 16:9

{
  "model": "gpt-image-2",
  "prompt": "A futuristic city night poster with neon lights, wet streets, cinematic composition, no text",
  "n": 1,
  "size": "2048x1152",
  "resolution": "2k",
  "quality": "medium",
  "output_format": "jpeg"
}

Cách trả kết quả

Điểm cuối tương thích OpenAI này không trả trước phản hồi gửi tác vụ chứa data.jobId để truy vấn sau:

• Với stream: false, yêu cầu HTTP hiện tại chờ hoàn tất và trả URL ảnh trong phản hồi JSON.
• Với stream: true, kết nối SSE hiện tại giữ mở qua image_generation.completed và [DONE].

Không dùng GET https://api.apihop.ai/v1/jobs/{id} để lấy kết quả từ điểm cuối này. Chỉ dùng Lấy công việc bất đồng bộ khi điểm cuối tạo bất đồng bộ trả rõ jobId.

Phản hồi không truyền luồng

Phản hồi chứa URL ảnh. Có usage khi tuyến thượng nguồn cung cấp thông tin đo lường.

{
  "created": 1777270000,
  "data": [
    {
      "url": "https://image.example.com/generated/123456789012345678/0.png"
    }
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 1234,
    "total_tokens": 1254
  }
}

Phản hồi truyền luồng

event: image_generation.completed
data: {"type":"image_generation.completed","data":[{"index":0,"url":"https://image.example.com/generated/123456789012345678/0.png"}],"usage":{"input_tokens":20,"output_tokens":1234,"total_tokens":1254}}

data: [DONE]

Tham chiếu kích thước

Phản hồi lỗi

Xem Mã lỗi và khắc phục để có tham chiếu mã đầy đủ, khác biệt giao thức và bước chẩn đoán.

{
  "code": 10000,
  "message": "prompt is required",
  "type": "api_error"
}

Lỗi phổ biến:

• 400: thiếu tham số bắt buộc hoặc tổ hợp tham số không được hỗ trợ
• 401: xác thực thất bại hoặc khóa API không đúng
• 402: số dư không đủ
• 404: mô hình không tồn tại hoặc chưa bật
• 429: vượt giới hạn tốc độ
• 5xx: dịch vụ tạm không khả dụng hoặc tạo ảnh thất bại