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 ả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 request đầu tiên đơ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 ả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 nhà cung cấp đó, nhưng hãy giữ n ở mức 1

​
Request đầu tiên an toàn

  • Bắt đầu với dall-e-3
  • Giữ size ở 1024x1024
  • Đặt response_format: "url" nếu bạn muốn một phản hồi JSON nhỏ và một URL tải xuống tạm thời
  • Dùng một prompt và một ảnh trước khi bạn 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 phù hợp hơn khi được dùng như các route ưu tiên base64
  • qwen-image không hỗ trợ n > 1
Ảnh được tạo phải tuân thủ chính sách sử dụng của nhà cung cấp. Không gửi các prompt vi phạm pháp luật, 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