Cara Generate AI Gratis di GrowthCircle dengan GPT Image 2

GrowthCircle menyediakan AI Console dengan endpoint publik di https://ai.growthcircle.id. Dari sisi developer atau agent, cara pakainya mirip OpenAI-compatible API: simpan key, cek daftar model, lalu panggil endpoint sesuai capability.

Artikel ini versi terbaru berdasarkan dokumentasi GrowthCircle AI Console, file llms.txt, dan halaman plugin gc-provider di ClawHub. Saya juga mengetes model discovery, chat completion, dan submit task image generation memakai key test yang dimasking. Key tidak ditulis di artikel.

Ringkasan perubahan update Mei 2026

Yang berubah dari versi lama:

1. Jangan menebak nama model seperti gpt-image-2-free. Source of truth adalah GET /v1/models dengan key yang dipakai.
2. API langsung memakai model ID persis dari /v1/models, misalnya gpt-image-2.
3. Di OpenClaw dengan gc-provider, model bisa dipanggil sebagai growthcircle/gpt-image-2.
4. Image generation bisa async. Jika response mengembalikan data[0].task_id, hasilnya diambil lewat GET /v1/tasks/{task_id}.
5. Beberapa model menerima size konkret seperti 1024x1024, sebagian bisa menerima ratio seperti 1:1. Cek supported_parameters.
6. Key free, paid, dan team bisa melihat daftar model berbeda. Jangan pakai suffix yang tidak muncul di model discovery.

Endpoint penting

Base URL:

https://ai.growthcircle.id/v1

Model discovery:

GET https://ai.growthcircle.id/v1/models
Authorization: Bearer <GROWTHCIRCLE_API_KEY>

Image generation:

POST https://ai.growthcircle.id/v1/images/generations
Authorization: Bearer <GROWTHCIRCLE_API_KEY>
Content-Type: application/json

Task polling:

GET https://ai.growthcircle.id/v1/tasks/{task_id}
Authorization: Bearer <GROWTHCIRCLE_API_KEY>

Simpan key dengan aman

Jangan taruh key di artikel, repo, frontend, atau chat publik. Simpan sebagai environment variable:

export GROWTHCIRCLE_API_KEY="gc-free-xxxxxxxxxxxxxxxx"

Untuk server production, simpan di env service, secret manager, atau mekanisme SecretRef yang dipakai OpenClaw.

Cek model yang tersedia

Selalu mulai dari /v1/models:

curl https://ai.growthcircle.id/v1/models \
 -H "Authorization: Bearer $GROWTHCIRCLE_API_KEY"

Gunakan ID yang muncul dari response. Untuk key test free yang saya pakai, model discovery mengembalikan gpt-image-2 sebagai available untuk current key. Karena itu contoh API langsung di artikel ini memakai model gpt-image-2, bukan gpt-image-2-free.

Contoh filter sederhana:

curl https://ai.growthcircle.id/v1/models \
 -H "Authorization: Bearer $GROWTHCIRCLE_API_KEY" \
 | jq '.data[] | select(.mode=="image_generation") | {id, supported_parameters, available_for_current_key}'

Kalau jq belum ada, baca response mentah dulu. Yang penting, jangan menebak model ID.

Generate gambar via curl

Contoh text-to-image:

curl https://ai.growthcircle.id/v1/images/generations \
 -H "Authorization: Bearer $GROWTHCIRCLE_API_KEY" \
 -H "Content-Type: application/json" \
 --data '{
 "model": "gpt-image-2",
 "prompt": "A clean product mockup on a white desk, soft lighting",
 "n": 1,
 "size": "1:1"
 }'

Jika model menolak size, baca pesan error dan cek supported_parameters dari /v1/models. Sebagian lane image lebih suka size konkret seperti 1024x1024 atau 1536x1024. Sebagian menerima ratio-style seperti 1:1.

Response bisa langsung berisi URL, atau bisa berisi task_id:

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

Kalau response seperti ini, lanjut poll task:

curl https://ai.growthcircle.id/v1/tasks/imgtask_xxx \
 -H "Authorization: Bearer $GROWTHCIRCLE_API_KEY"

Jika hasil asset berupa path /api/assets/..., resolve ke:

https://growthcircle.id/api/assets/...

Image-to-image

Endpoint-nya sama. Tambahkan image_urls:

curl https://ai.growthcircle.id/v1/images/generations \
 -H "Authorization: Bearer $GROWTHCIRCLE_API_KEY" \
 -H "Content-Type: application/json" \
 --data '{
 "model": "gpt-image-2",
 "prompt": "Keep the product shape, change the background into a clean teal studio scene",
 "n": 1,
 "size": "1:1",
 "image_urls": [
 "https://example.com/product.jpg"
 ]
 }'

Reference image harus URL publik yang bisa diakses API. Instruksi edit tetap ditulis di prompt, bukan disisipkan di URL gambar.

Pakai di OpenClaw

Untuk OpenClaw yang sudah memasang gc-provider, model ref biasanya memakai prefix provider:

growthcircle/gpt-image-2

Contoh config:

{
 "agents": {
 "defaults": {
 "imageGenerationModel": {
 "primary": "growthcircle/gpt-image-2",
 "timeoutMs": 180000
 }
 }
 }
}

Lalu test dari OpenClaw:

/tool image_generate action=generate model=growthcircle/gpt-image-2 prompt="A clean product mockup" aspectRatio=1:1 count=1

Kalau belum memakai gc-provider, gunakan provider OpenAI-compatible sesuai dokumentasi GrowthCircle AI Console. Base URL tetap https://ai.growthcircle.id/v1 dan auth header tetap Authorization: Bearer.

Free, paid, dan team key

Jangan samakan semua key.

Free key memakai kuota free dan bisa limit saat padat.

Paid key memakai balance member.

Team atau Patungan key memakai route team dan hanya boleh memakai model yang muncul dari /v1/models untuk key itu. Untuk team image, dokumentasi GrowthCircle menyebut gc-image-pro atau varian gc-image-pro-* jika model itu memang muncul. Jangan pakai gpt-image-2 hanya karena paid/free punya model itu.

Kesimpulan

Cara paling aman generate AI gratis di GrowthCircle:

1. Simpan key sebagai env.
2. Jalankan GET /v1/models.
3. Pakai model ID persis dari response.
4. Submit ke POST /v1/images/generations.
5. Kalau dapat task_id, poll GET /v1/tasks/{task_id}.
6. Di OpenClaw, pakai prefix provider seperti growthcircle/gpt-image-2 setelah gc-provider aktif.

Jangan masukkan key ke artikel, repo, atau frontend. Jangan juga menebak suffix model. GrowthCircle sudah menyediakan model discovery; pakai itu sebagai sumber kebenaran.