Pembuatan dan Pengeditan Gambar

Buat dan edit gambar dengan titik akhir yang kompatibel dengan OpenAI, mendukung multipart dan URL gambar JSON.

Gambaran Umum

Buat gambar baru atau edit gambar yang ada menggunakan rute gambar standar OpenAI, mendukung unggahan file multipart dan input URL gambar JSON non-streaming untuk gpt-image-2.

Pembuatan Gambar

POST/v1/images/generations
  • Titik akhir kanonis: POST /v1/images/generations (operationId: openai.images.generations) membuat gambar dari perintah teks.
  • Parameter pembuatan: Menerima prompt, serta model, n, quality, dan size opsional.
  • Alias kompatibilitas: Menerima POST /openai/v1/images/generations (operationId: openai.images.generations.alias).

Pengeditan Gambar

POST/openai/v1/images/edits
json
{
  "model": "gpt-image-2",
  "prompt": "Gabungkan gambar referensi ini menjadi potret surealis yang koheren.",
  "images": [
    { "image_url": "https://cdn.example.com/reference-1.png" },
    { "image_url": "https://cdn.example.com/reference-2.png" }
  ],
  "mask": {
    "image_url": "https://cdn.example.com/mask.png"
  },
  "n": 1,
  "quality": "medium",
  "size": "1024x1024"
}
  • Titik akhir kanonis: POST /openai/v1/images/edits (operationId: openai.images.edits) dengan alias kompatibilitas POST /v1/images/edits (operationId: openai.images.edits.alias).
  • Input URL JSON: Untuk gpt-image-2 dan saluran hulu native yang didukung, kirim JSON non-streaming dengan model, prompt, larik images berisi 1 hingga 16 objek dengan image_url, dan objek mask opsional (image_url).
  • Persyaratan HTTPS publik: URL gambar harus berupa alamat HTTPS publik tanpa kredensial tersemat agar penyedia hulu dapat membacanya langsung.
  • Kontrol kualitas dan dimensi: gpt-image-2 menggunakan kualitas medium secara default (low dan high juga didukung); parameter native tambahan diteruskan tanpa perubahan.
  • Operasi yang didukung: Diterbitkan di bawah operationId: openai.images.edits dengan alias kompatibilitas POST /v1/images/edits.