Cara Generate AI Gratis di GrowthCircle dengan gpt-image-2

Kalau Anda butuh cara cepat untuk generate gambar AI lewat API tanpa setup yang ribet, jalur GrowthCircle + gpt-image-2 sekarang sudah cukup enak dipakai.

Yang penting, ada beberapa detail teknis yang perlu benar dari awal:

• endpoint submit ada di https://ai.growthcircle.id
• model yang dipakai: gpt-image-2
• request image generation bersifat async
• untuk cek file hasil, pakai GET, jangan andalkan HEAD
• parameter size dipakai dalam bentuk rasio, bukan 1024x1024

Artikel ini merangkum flow yang sudah lolos smoke test dan bisa langsung dipakai buat implementasi.

Smoke test yang lolos

Dari pengujian live, jalur ini berhasil dengan hasil berikut:

• endpoint: https://ai.growthcircle.id
• model: gpt-image-2
• submit generation: 200 OK
• task status final: completed
• asset image hasil: GET 200 dengan tipe file image
• catatan penting: asset route valid saat diakses pakai GET; pada beberapa cek, HEAD bisa memberi 404, jadi verifikasi file sebaiknya pakai GET

1) Simpan API key di env lokal

Jangan hardcode API key langsung ke script. Simpan dulu di environment variable:

export GC_API_KEY="ISI_API_KEY_KAMU"
export GC_BASE_URL="https://ai.growthcircle.id"

Kalau mau lebih rapi, simpan ke .env lokal dan load saat runtime.

2) Cek model yang tersedia

Sebelum submit job, cek dulu apakah model gpt-image-2 memang tersedia di endpoint aktif.

curl "$GC_BASE_URL/v1/models" \
 -H "Authorization: Bearer $GC_API_KEY"

Cari item seperti ini:

{
 "id": "gpt-image-2",
 "provider": "openai"
}

Kalau model ini muncul, berarti environment Anda sudah membaca model yang benar.

3) Submit generate gambar

Flow generate-nya async. Jadi request pertama hanya mengembalikan status submit + task_id.

curl "$GC_BASE_URL/v1/images/generations" \
 -H "Authorization: Bearer $GC_API_KEY" \
 -H "Content-Type: application/json" \
 -d '{
 "model": "gpt-image-2",
 "prompt": "A clean emerald and slate illustration of a modern creative workspace, no text",
 "size": "1:1",
 "n": 1
 }'

Contoh respons awal:

{
 "code": 200,
 "data": [
 {
 "status": "submitted",
 "task_id": "imgtask_xxx"
 }
 ]
}

Kalau Anda dapat task_id, berarti request submit sudah lolos.

4) Poll task sampai selesai

Setelah submit, cek status task berkala.

curl "$GC_BASE_URL/v1/tasks/imgtask_xxx" \
 -H "Authorization: Bearer $GC_API_KEY"

Saat selesai, Anda akan melihat status completed dan URL hasil gambar di response task.

Contoh struktur yang dicari:

{
 "data": {
 "status": "completed",
 "result": {
 "images": [
 {
 "url": [
 "/api/assets/ai-images/..."
 ]
 }
 ]
 }
 }
}

5) Buka atau download hasil gambar

Kalau response mengembalikan path relatif seperti /api/assets/ai-images/..., gabungkan dengan base domain asset yang valid di environment Anda.

Contoh paling aman untuk download:

curl -o result.png "https://growthcircle.id/api/assets/ai-images/..."

Kalau di environment Anda route asset aktif di host yang sama, uji pakai GET. Jangan heran kalau HEAD tidak konsisten.

Parameter penting yang perlu diingat

model

Wajib diisi, dan untuk tutorial ini nilainya:

"model": "gpt-image-2"

prompt

Wajib. Semakin jelas prompt, semakin stabil hasilnya.

n

Untuk flow gpt-image-2 di jalur ini, aman asumsikan 1 output per request.

"n": 1

size

Di jalur ini, size dipakai sebagai rasio, bukan ukuran piksel seperti 1024x1024.

Rasio yang aman dipakai:

• 1:1
• 16:9
• 9:16
• 4:3
• 3:4
• 3:2
• 2:3
• 5:4
• 4:5
• 2:1
• 1:2
• 21:9
• 9:21

Kalau mau image-to-image

Di jalur request ini, Anda juga bisa menyiapkan referensi gambar dengan menambahkan field seperti:

"image_urls": [
 "https://example.com/reference.png"
]

Kalau baru mulai, saran paling aman tetap mulai dari text-to-image dulu supaya flow dasar submit -> poll -> download benar-benar clear.

Contoh hasil generate

Berikut satu contoh output live yang berhasil ditarik dari jalur GrowthCircle + gpt-image-2 pada sesi uji artikel ini.

Contoh ini cukup untuk menunjukkan hal yang paling penting: submit bisa masuk, task bisa selesai ke status completed, dan asset hasil memang bisa diambil lewat route yang benar.

Catatan operasional: karena key free punya limit kuota, jumlah contoh live yang di-generate per sesi bisa terbatas. Jadi untuk testing yang lebih banyak, siapkan slot kuota berikutnya atau gunakan key berbayar.

Flow paling ringkas kalau mau langsung jalan

Kalau Anda hanya mau versi singkatnya, urutannya begini:

1. set GC_API_KEY dan GC_BASE_URL
2. cek /v1/models
3. submit ke /v1/images/generations
4. ambil task_id
5. poll /v1/tasks/<task_id>
6. download asset hasil dengan GET

Kesalahan yang paling sering bikin bingung

Mengira request-nya sync

Padahal tidak. Submit awal hanya memberi status submitted.

Mengecek file hasil dengan HEAD

Di smoke test yang dipakai untuk artikel ini, route asset lebih aman dicek pakai GET.

Mengisi size dengan piksel

Untuk jalur ini, lebih aman pakai rasio seperti 1:1 atau 16:9.

Menganggap error asset berarti task gagal

Belum tentu. Bisa jadi task sudah selesai, tetapi cara cek asset-nya yang salah.

Kesimpulan

Kalau tujuannya adalah generate gambar AI gratis di GrowthCircle dengan gpt-image-2, flow dasarnya sudah cukup jelas dan usable:

• model terbaca,
• submit generation berhasil,
• task bisa selesai sampai completed,
• asset hasil bisa diambil,
• dan beberapa rasio output bisa dipakai di jalur yang sama.

Kunci utamanya cuma tiga:

1. pakai endpoint yang benar,
2. pahami bahwa flow-nya async,
3. verifikasi asset hasil dengan GET, bukan HEAD.

Kalau tiga hal itu beres, implementasi dasar GrowthCircle untuk image generation sudah cukup siap dipakai buat eksperimen maupun integrasi kecil.