Buat gambar

POST

images

generations

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A paper boat floating on calm water at sunrise.",
    "quality": "low",
    "size": "1024x1024",
    "output_format": "jpeg"
  }'

{
  "created": 1781075000,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 13,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 13
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 209
  },
  "data": [
    {
      "b64_json": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }
  ]
}

Gunakan rute ini untuk membuat gambar dari teks dengan bentuk request yang kompatibel dengan OpenAI di CometAPI.

Referensi resmi

Baca panduan pembuatan gambar OpenAI sebelum Anda menggunakan kontrol khusus model seperti background, output_compression, streaming, atau opsi GPT image di masa mendatang.
Gunakan referensi OpenAI Create image untuk daftar parameter saat ini.

Pilih model terlebih dahulu

Gunakan model GPT image seperti gpt-image-2 untuk request text-to-image dengan kontrol seperti output_format, quality, atau background
Gunakan qwen-image ketika Anda secara khusus membutuhkan provider tersebut, tetapi pertahankan n di 1
Pilih model ID gambar saat ini dari halaman Models

Request pertama yang aman

Mulai dengan gpt-image-2
Pertahankan size di 1024x1024
Model GPT image mengembalikan data gambar yang dienkode base64 dalam b64_json; decode data tersebut untuk menyimpan file gambar
Tambahkan output_format hanya saat Anda membutuhkan tipe gambar terenkode tertentu seperti jpeg
Periksa panduan pembuatan gambar OpenAI sebelum Anda menambahkan background, output_compression, atau streaming
Gunakan satu prompt dan satu gambar output sebelum Anda menambahkan pembuatan batch atau penyesuaian gaya

Jalankan task gambar async

Gunakan async: true untuk job gambar yang berjalan lama ketika client Anda lebih memilih alur kirim-dan-poll dibandingkan menahan satu koneksi HTTP tetap terbuka. Request create mengembalikan data.task_id. Lakukan poll ke Retrieve an image generation task sampai data.status bernilai success atau failure. Field async adalah ekstensi CometAPI untuk rute ini, bukan parameter OpenAI. OpenAI mendokumentasikan stream dan partial_images untuk model GPT image. Mode task asynchronous CometAPI mengembalikan metadata task JSON dan menggunakan polling. Gunakan mode task async dengan model ID yang terdokumentasi berikut: gpt-image-2 dan doubao-seedream-4-0-250828. Untuk model gambar lainnya, gunakan pembuatan sinkron atau streaming kecuali dukungan task async didokumentasikan untuk model tersebut. Ketika sebuah request menyertakan async: true dan stream: true, mode task async akan diprioritaskan. Request create mengembalikan metadata task JSON alih-alih stream SSE.

Perilaku request khusus model

response_format hanya berlaku untuk model DALL·E; model GPT image mengembalikan data base64 dan mengabaikannya
Model GPT image menggunakan kontrol khusus GPT seperti output_format, quality, background, dan output_compression
Ikuti panduan pembuatan gambar OpenAI untuk opsi khusus model terbaru
qwen-image tidak mendukung n > 1

Gambar yang dihasilkan harus mematuhi kebijakan penggunaan provider. Jangan kirim prompt yang ilegal, mengandung kekerasan, pornografi, atau melanggar hak cipta.

Otorisasi

Authorization

string

header

wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json

model

string

default:gpt-image-2

wajib

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

prompt

string

wajib

Text description of the image you want to generate.

Contoh:

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

integer

default:1

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

quality

string

Quality setting for models that support it. See the OpenAI image generation guide for the latest model-specific values.

size

string

Requested output size. Supported values depend on the selected model. See the OpenAI image generation guide for the latest model-specific ranges.

Contoh:

"1024x1024"

response_format

enum<string>

The response container for dall-e-2 and dall-e-3. This parameter is not supported for GPT image models, which return base64-encoded image data.

Opsi yang tersedia:

url,

b64_json

output_format

string

The encoded image type for GPT image model results, such as png, jpeg, or webp. See the OpenAI image generation guide for current GPT image output controls.

Contoh:

"jpeg"

stream

boolean

default:false

Set this to true to receive server-sent image generation events instead of waiting for the completed JSON response. Streaming responses use text/event-stream and can include final events such as image_generation.completed. When stream and async are both true, async task mode takes precedence and the create request returns JSON instead of a streaming image response.

async

boolean

default:false

CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll GET /v1/images/generations/{task_id} for the final image data. Documented model IDs for this mode: gpt-image-2 and doubao-seedream-4-0-250828. This is a CometAPI extension, not an OpenAI parameter. When async and stream are both true, async takes precedence and returns JSON task metadata instead of an SSE stream.

Respons

Image generation result. Synchronous requests return completed image data. Async requests return a task response with data.task_id.

Completed image response
Async task response

created

integer

wajib

Unix timestamp for the completed generation.

data

object[]

wajib

Show child attributes

background

string

Background mode returned by models that expose it.

output_format

string

Encoded image type returned by GPT image models.

quality

string

Quality level returned by models that expose it.

size

string

Output size returned by models that expose it.

usage

object

Token usage details when returned by the selected model.

Show child attributes

API pembuatan dan pengeditan gambar

Sebelumnya

Mengambil task pembuatan gambar

Selanjutnya

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A paper boat floating on calm water at sunrise.",
    "quality": "low",
    "size": "1024x1024",
    "output_format": "jpeg"
  }'

{
  "created": 1781075000,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 13,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 13
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 209
  },
  "data": [
    {
      "b64_json": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }
  ]
}

Moderasi konten

Kunci API

Referensi resmi

Pilih model terlebih dahulu

Request pertama yang aman

Jalankan task gambar async

Perilaku request khusus model

Otorisasi

Body

Respons

​Referensi resmi

​Pilih model terlebih dahulu

​Request pertama yang aman

​Jalankan task gambar async

​Perilaku request khusus model

Otorisasi

Body

Respons

Referensi resmi

Pilih model terlebih dahulu

Request pertama yang aman

Jalankan task gambar async

Perilaku request khusus model