Creovox API

Hızlı başlangıç

1. 01

   API anahtarı oluşturun

   Giriş yapın ve paneldeki API Keys bölümünü açın. Her uygulama için ayrı bir anahtar oluşturun; böylece birini devre dışı bırakırken diğerleri çalışmaya devam eder.

2. 02

   Kredi satın alın

   API yalnızca satın alınan kredileri harcar. Ücretsiz ve bonus krediler web sitesinde çalışmaya devam eder, ancak API üzerinden kullanılamaz.

3. 03

   Görev oluşturup sorgulayın

   Promptunuzu POST ile /api/v1/tasks adresine gönderin, task_id değerini saklayın, ardından durum succeeded veya failed olana kadar birkaç saniyede bir GET /api/v1/tasks/ çağırın.

Kimlik doğrulama

Anahtarınızı her istekte Authorization başlığında gönderin. Anahtarlar Creovox hesabınıza bağlıdır; başka sitelerde oluşturulan anahtarlar reddedilir. Anahtarı asla tarayıcı koduna veya herkese açık bir depoya koymayın.

Authorization: Bearer YOUR_API_KEY

Uç noktalar

Görev oluşturma

Modelin id değerini model alanına, parametrelerini input alanına koyun. Bilinmeyen parametre adları reddedilir, böylece yazım hataları hemen hata verir. Her isteğe bir Idempotency-Key başlığı ekleyin; böylece yeniden denenen bir istek ikinci bir görev oluşturmaz ve ikinci kez ücretlendirmez.

curl -X POST https://creovox.ai/api/v1/tasks \
  -H "Authorization: Bearer $CREOVOX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1234-fox" \
  -d '{
    "model": "gpt-image-2.6",
    "input": {
      "prompt": "A red fox in fresh snow, cinematic light",
      "variant": "flare",
      "aspect_ratio": "16:9",
      "resolution": "2k"
    }
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n42…gptimg",
    "model": "gpt-image-2.6",
    "status": "processing",
    "output": null,
    "credits_charged": 20,
    "refund_pending": false,
    "error": null,
    "created_at": "2026-11-07T08:00:00.000Z"
  }
}

GPT Image 2.6 parametreleri

Sonucu sorgulama

Her 3 ila 5 saniyede bir sorgulayın ve durum succeeded veya failed olduğunda durun. Görseller genellikle birkaç saniyeden birkaç dakikaya kadar sürer; bir görev 10 dakika sonra hâlâ processing ise sorgulamayı bırakın ve task_id değeriyle destek ekibine ulaşın. Görev başarılı olduğunda output.images görsel URL'lerini içerir; uzun süre saklayacaksanız indirin.

curl https://creovox.ai/api/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $CREOVOX_API_KEY"

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n42…gptimg",
    "model": "gpt-image-2.6",
    "status": "succeeded",
    "output": { "images": [{ "url": "https://…/image.png" }] },
    "credits_charged": 20,
    "refund_pending": false,
    "error": null,
    "created_at": "2026-11-07T08:00:00.000Z"
  }
}

Görev durumu

processing

Görev işleniyor veya ücret kesintisinin ya da sağlayıcının görevi kabul ettiğinin onaylanmasını bekliyor.

succeeded

Bitti. output.images sonuçları içerir ve credits_charged kesin değerdir.

failed

Üretim başarısız oldu ve error.message nedenini açıklar. Tahsil edilen krediler otomatik olarak iade edilir: iade tamamlanana kadar refund_pending true olur, ardından credits_charged 0 gösterir. Sorgulamayı durdurabilirsiniz.

// Node.js 18+
const API = 'https://creovox.ai/api/v1'
const headers = {
  Authorization: `Bearer ${process.env.CREOVOX_API_KEY}`,
  'Content-Type': 'application/json',
}

async function call(path, init = {}) {
  const res = await fetch(API + path, { ...init, headers: { ...headers, ...init.headers }, signal: AbortSignal.timeout(30_000) })
  const body = await res.json().catch(() => ({ code: res.status, message: res.statusText }))
  if (body.code !== 200) {
    const error = new Error(body.message)
    Object.assign(error, { status: res.status, type: body.error_type, data: body.data, retryAfter: res.headers.get('retry-after') })
    throw error
  }
  return body.data
}

// Reuse the same key when you retry this request: you get the same task and pay once.
const idempotencyKey = crypto.randomUUID()
let task
try {
  task = await call('/tasks', {
    method: 'POST',
    headers: { 'Idempotency-Key': idempotencyKey },
    body: JSON.stringify({ model: 'gpt-image-2.6', input: { prompt: 'A red fox in fresh snow' } }),
  })
} catch (error) {
  if (!error.data?.task_id || !['billing_unconfirmed', 'submission_unconfirmed'].includes(error.type)) throw error
  task = { task_id: error.data.task_id, status: 'processing' }
}

const deadline = Date.now() + 10 * 60_000
while (task.status === 'processing') {
  if (Date.now() > deadline) throw new Error(`Task ${task.task_id} is still processing; contact support.`)
  await new Promise(resolve => setTimeout(resolve, 4000))
  try {
    task = await call(`/tasks/${task.task_id}`)
  } catch (error) {
    // 429 and 5xx are temporary: wait and poll again. Anything else is final.
    if (error.status !== 429 && error.status < 500) throw error
    await new Promise(resolve => setTimeout(resolve, (Number(error.retryAfter) || 5) * 1000))
  }
}
console.log(task.status, task.output?.images, task.error, task.refund_pending)

Fiyatlandırma

Fiyatlar kredi cinsindendir ve web sitesiyle birebir aynıdır. 1 kredi = US$0.01. Her referans görsel küçük bir tutar ekler. GET /api/v1/models her zaman güncel fiyat listesini döndürür.

Hatalar

Hatalar HTTP durum kodunu ve aynı JSON yapısını kullanır: code, message, error_type ve data.

Sınırlar ve iyi uygulamalar

• Her anahtarın dakika başına ve çalışan görev sınırı vardır. Ücretli planlarda sınırlar daha yüksektir.
• Her oluşturma isteğinde bir Idempotency-Key başlığı gönderin. Bir istek zaman aşımına uğrarsa aynı Idempotency-Key ile yeniden deneyin: aynı görevi alırsınız ve iki kez ücretlendirilmezsiniz.
• Referans görseller herkese açık internetten erişilebilir olmalıdır. İmzalı URL'ler birkaç dakika geçerli kaldığı sürece çalışır.
• Görevler özeldir. Bir anahtar yalnızca kendi oluşturduğu görevleri okuyabilir.

SSS