Gelistirici Kaynaklari

Grok 5 Imagine API Dokumantasyonu

xAI'nin Grok 5 Imagine modelini uygulamalariniza entegre edin. Basit REST API ile metinden gorsele, metinden videoya ve gorselden videoya uretim destegi.

Kimlik Dogrulama

Grok 5 Imagine API, Bearer Token kimlik dogrulamasini kullanir. API anahtarinizi istek basliginda (header) iletin.

Kimlik Dogrulama

Authorization: Bearer sk-your-api-key-here

API anahtarinizi guvende tutun. Istemci tarafindaki kodlarda paylasmayın.

Fiyatlandirma

Tur	Maliyet	Aciklama
Metinden Gorsele `(text2img)`	5 Kredi	Grok 5 AI ile metin istemlerinden (prompt) gorseller olusturun.
Metinden Videoya `(text2video)`	24 Kredi	Grok 5 AI ile metin istemlerinden videolar olusturun.
Gorselden Videoya `(img2video)`	24 Kredi	Grok 5 AI ile gorsellerden videolar olusturun.

Gorev Olustur

POSThttps://grok5ai.com/api/generate

Asenkron Uretim

Fiyatlandirma

Krediler modele gore degisir: text2img 5 kredi, text2video ve img2video her biri 24 kredi tutar.

Bir uretim gorevi baslatin. API, sonuclari sorgulamak icin kullanacaginiz bir task_id degerini aninda dondurur.

Govde Parametreleri

Parametre	Tur	Zorunlu	Aciklama
model	string	Zorunlu	Kullanilacak model: text2img, text2video veya img2video.
prompt	string	Kosullu	Uretim icin metin aciklamasi. Maksimum 5000 karakter. text2img ve text2video icin zorunlu.
image_urls	array	Kosullu	img2video modu icin gorsel URL'leri dizisi. task_id verilmediyse zorunlu.
task_id	string	Kosullu	Giris gorseli olarak kullanilacak onceki uretimin gorev ID'si. image_urls verilmediyse zorunlu.
callback_url	string	Istege Bagli	Gorev tamamlanma bildirimi icin Webhook URL'si.

Istek Ornekleri

Metinden Gorsele Ornegi (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2img",
    "prompt": "A serene mountain landscape at sunset"
  }'

Metinden Videoya Ornegi (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2video",
    "prompt": "A timelapse of clouds moving over mountains"
  }'

Gorselden Videoya Ornegi (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "img2video",
    "image_urls": ["https://example.com/image.jpg"]
  }'

Basarili Yanit

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS"
  }
}

Hata Yaniti

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

Durum Kontrolu

GEThttps://grok5ai.com/api/status

Gorevinizin ilerlemesini kontrol etmek icin bu uc noktayi sorgulayin. Her 5-10 saniyede bir sorgulamanizi oneririz.

Sorgu Parametreleri

Parametre	Tur	Aciklama
task_id	string	Uretim uc noktasindan alinan gorev kimligi (task ID). Zorunlu

Durum Degerleri

PENDINGGorev sirada

IN_PROGRESSIsleniyor

SUCCESSTamamlandi

FAILEDHata olustu

cURL

curl -X GET "https://grok5ai.com/api/status?task_id=grok5abc123def456img" \
  -H "Authorization: Bearer YOUR_API_KEY"

Yanit (Devam Ediyor)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

Yanit (Tamamlandi)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

Yanit (Basarisiz)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Hata Kodlari

Kod	Aciklama
200	Basarili
400	Gecersiz Istek - Gecersiz parametreler (eksik istem, gecersiz model vb.)
401	Yetkisiz - Eksik veya gecersiz API anahtari
404	Bulunamadi - Gorev kimligi mevcut degil
500	Sunucu Hatasi - Lutfen tekrar deneyin veya destekle iletisime gecin

Yardima mi ihtiyaciniz var?

Destek kanalimiza goz atin veya bize e-posta gonderin.

Destekle Iletisime Gecin