Edit Gambar

IkhtisarCopy Anchor Link

Membuat gambar hasil edit atau diperluas dari gambar asli dan prompt.

Route ini mendukung:

• alur upload multipart/form-data kompatibel OpenAI yang didokumentasikan di bawah
• request JSON yang menyediakan image_url, image_urls, atau referensi resmi images untuk keluarga image-to-image yang didukung

Body RequestCopy Anchor Link

Timeout permintaan sinkron: beberapa request gambar mengembalikan gambar final secara inline dan menunggu proses generasi selesai. Permintaan resolusi tinggi atau kualitas tinggi dapat memakan waktu hampir satu menit atau lebih, jadi atur timeout HTTP client Anda minimal 120s. Jika respons pembuatan berisi status: "pending", task_id, atau poll_url, ikuti poll_url yang dikembalikan.

URL gambar jarak jauh: ketika input multipart diperlukan, TokenLab mengambil JSON image_url, image_urls, atau images[].image_url lalu mengirim byte-nya sebagai part multipart image. URL harus publik melalui http/https, tanpa kredensial tertanam atau fragment, dan tidak boleh resolve ke localhost, rentang IP privat, atau IP reserved; setiap redirect divalidasi ulang. Payload yang diambil harus benar-benar berupa gambar PNG, JPEG, atau WebP. Batasnya 50 MiB per gambar, total 200 MiB untuk gambar yang diambil dari URL dalam satu request, timeout 30s, dan maksimal 3 redirect.

Permintaan JSON harus menyertakan tepat satu dari image_url, image_urls, atau images. Setiap objek images[] harus berisi tepat satu dari image_url atau file_id. Batas total 200 MiB mencakup semua gambar sumber dan mask.

ResponsCopy Anchor Link

Respons Task AsyncCopy Anchor Link

Setel async: true dengan gpt-image-2 atau model edit resmi FLUX/BFL untuk membuat task alih-alih menunggu gambar hasil edit di request. Respons berisi status: "pending", task_id, dan poll_url. Poll /v1/tasks/{task_id} hingga task menjadi completed atau failed.

Task edit async hanya mengembalikan URL gambar final. Jika membutuhkan data gambar mentah b64_json, gunakan request sinkron.

Saat task dibuat, biaya perkiraan dapat dicadangkan terlebih dahulu. Task yang selesai ditagih sesuai pemakaian aktual; task yang gagal atau timeout akan melepaskan atau mengembalikan cadangan biaya.

curl -X POST "https://api.tokenlab.sh/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=gpt-image-2" \
  -F "image=@sunlit_lounge.png" \
  -F "mask=@mask.png" \
  -F "prompt=A sunlit indoor lounge area with a pool" \
  -F "n=1" \
  -F "size=1024x1024"

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

CatatanCopy Anchor Link

{
  "model": "hy-image-v3.5-preview",
  "prompt": "Change the table to pale blue",
  "image_url": "https://example.com/reference.png",
  "size": "1024x1024",
  "n": 1,
  "response_format": "url"
}