Grok 5 Imagine Üretimi

API Dokümantasyonu

Grok 5 Imagine işlerini göndermek ve durumlarını kontrol etmek için bu uç noktaları kullanın. Her çağrı, kullanılan modele bağlı olarak kredi harcar.

Kimlik Doğrulama

Tüm istekler, API anahtarınızı Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Eksik veya geçersiz anahtarlar şunu döndürür 401 Unauthorized.

POST

https://grok5imagine.com/api/generate

Üretim görevi oluştur

Yeni bir Grok 5 Imagine işi gönderir. Çağrı, oluşturma işlemi asenkron olarak tamamlanırken hemen bir task_id döndürür.

Parametre	Tür	Gerekli	Açıklama
model	string	Hayır	Kullanılacak model: grok-imagine/text-to-image (varsayılan), text-to-video, image-to-video veya upscale.
input	object	Evet	Modele göre prompt, image_urls veya task_id içeren giriş parametreleri nesnesi.
input.prompt	string (max 5000 chars)	Hayır	Ne oluşturulacağını açıklayan metin istemi (text-to-image ve text-to-video için gerekli).
input.image_urls	string[]	Hayır	Görüntü URL'leri dizisi (image-to-video için gerekli).
input.task_id	string	Hayır	Upscale veya image-to-video üretimi için önceki görev ID'si.
callback_url	string	Hayır	Görev tamamlama bildirimlerini almak için webhook URL'si.
public	boolean	Hayır	Görevi genel galerilere aç.

Kredi Tüketimi

Krediler, görev oluşturulduğunda düşülür. Başarısız işler otomatik olarak iade edilir.

Model	Düşülen Krediler
grok-imagine/text-to-image	5
grok-imagine/text-to-video	24
grok-imagine/image-to-video	24
grok-imagine/upscale	12

Örnek istek

{
  "model": "grok-imagine/text-to-image",
  "input": {
    "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
  }
}

Örnek yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "IN_PROGRESS"
  }
}

GET / POST

https://grok5imagine.com/api/status

Görev durumunu kontrol et

En son kaydı sorgulamak için bu uç noktayı kullanın. Görev hala IN_PROGRESS durumundayken, yanıt vermeden önce sağlayıcıyı bir kez daha sorgularız.

Parametre	Tür	Gerekli	Açıklama
task_id	string	Evet	/generate tarafından döndürülen ID. Sorgu (?task_id=) veya JSON gövdesi aracılığıyla gönderin.

Alan	Açıklama
task_id	/generate'den dönen ID.
status	SUCCESS (BAŞARILI)
request	Gönderilen yükün temizlenmiş kopyası.
response	Durum SUCCESS olduğunda resultUrls dizisi içeren nesne.
consumed_credits	Görev için tahsil edilen krediler (iade edildiğinde 0).
error_message	Durum FAILED olduğunda sağlayıcı hatası.
created_at	İşin saklandığı UTC zaman damgası.

Örnek istek

GET https://grok5imagine.com/api/status?task_id=n31b6d54c8f4b4c4e8kie
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://grok5imagine.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n31b6d54c8f4b4c4e8kie"
}

Örnek yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "SUCCESS",
    "request": {
      "model": "grok-imagine/text-to-image",
      "input": {
        "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
      }
    },
    "response": {
      "resultUrls": [
        "https://static.gogloai.com/grok-imagine/image_001.png"
      ]
    },
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Hata Yönetimi

401 Unauthorized - Eksik veya geçersiz API anahtarı.
402 Payment Required - Kredi bakiyesi düşülen tutarı karşılayamadı.
429 Too Many Requests - Sorgulama sıklığını veya istek hızını azaltın.
500 - Geçici sorun; üstel geri çekilme ile yeniden deneyin.