Chuyển đến nội dung chính
POST
/
v1
/
images
/
generations
Create images
curl --request POST \
  --url https://api.cometapi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "dall-e-3",
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "created": 1773311889,
  "data": [
    {
      "revised_prompt": "A paper boat floating on calm water at sunrise, with soft golden light reflecting off the water's surface.",
      "url": "https://filesystem.site/cdn/20260312/1d6826050921c07a13ff173310c640.webp"
    }
  ]
}
Sử dụng route này để tạo hình ảnh từ văn bản với định dạng request tương thích OpenAI trên CometAPI.

​
Chọn model trước

  • Dùng dall-e-3 khi bạn muốn một bài kiểm tra nhanh đơn giản dựa trên URL
  • Dùng gpt-image-1, gpt-image-1-mini, hoặc gpt-image-1.5 khi bạn muốn các model hình ảnh GPT mới hơn và có thể xử lý phản hồi base64
  • Dùng qwen-image khi bạn cần đúng provider đó, nhưng giữ n ở mức 1

​
Request an toàn để bắt đầu

  • Bắt đầu với dall-e-3
  • Giữ size ở 1024x1024
  • Đặt response_format: "url" nếu bạn muốn phản hồi JSON nhỏ gọn và một URL tải xuống tạm thời
  • Dùng một Prompt và một hình ảnh trước khi thêm batch generation hoặc tinh chỉnh phong cách

​
Hành vi phản hồi theo từng model

  • dall-e-2 và dall-e-3 hỗ trợ phản hồi URL và phản hồi base64
  • gpt-image-1, gpt-image-1-mini, và gpt-image-1.5 nên được xem là các route ưu tiên base64
  • qwen-image không hỗ trợ n > 1
Trong quá trình xác thực thực tế vào ngày 2026-03-12, một request dall-e-3 với response_format: "url" đã trả về dấu thời gian created bình thường, một revised_prompt, và một URL hình ảnh tạm thời.
Hình ảnh được tạo phải tuân thủ chính sách sử dụng của provider. Không gửi các Prompt bất hợp pháp, bạo lực, khiêu dâm hoặc xâm phạm bản quyền.

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

application/json
​
model
string
mặc định:dall-e-3
bắt buộc

The image generation model to use. Choose a current model from the Models page.

​
prompt
string
bắt buộc

Text description of the image you want to generate.

Ví dụ:

"A paper boat floating on calm water at sunrise."

​
n
integer
mặc định:1

Number of images to generate. Keep this at 1 for the broadest compatibility.

​
size
string

Requested output size. Supported values depend on the selected model.

Ví dụ:

"1024x1024"

​
response_format
enum<string>

Requested output encoding for models that support it.

Tùy chọn có sẵn:
url,
b64_json

Phản hồi

200 - application/json

Image generation result.

​
created
integer
bắt buộc

Unix timestamp for the completed generation.

​
data
object[]
bắt buộc