Creovox API

Démarrage rapide

1. 01

   Créer une clé API

   Connectez-vous et ouvrez API Keys dans le tableau de bord. Créez une clé distincte par application pour en désactiver une sans casser les autres.

2. 02

   Acheter des crédits

   L'API ne dépense que les crédits achetés. Les crédits gratuits et bonus restent utilisables sur le site, mais pas via l'API.

3. 03

   Créer une tâche et l'interroger

   Envoyez votre prompt en POST sur /api/v1/tasks, conservez le task_id, puis faites GET /api/v1/tasks/ toutes les quelques secondes jusqu'à ce que le statut soit succeeded ou failed.

Authentification

Envoyez votre clé dans l'en-tête Authorization à chaque requête. Les clés sont liées à votre compte Creovox ; les clés créées sur d'autres sites sont refusées. Ne mettez jamais une clé dans du code navigateur ou un dépôt public.

Authorization: Bearer YOUR_API_KEY

Points de terminaison

Créer une tâche

Placez l'id du modèle dans model et ses paramètres dans input. Les noms de paramètres inconnus sont refusés, pour que les fautes de frappe échouent tout de suite. Envoyez un en-tête Idempotency-Key pour qu'une requête renvoyée ne crée ni ne facture une seconde tâche.

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"
  }
}

Paramètres de GPT Image 2.6

Interroger le résultat

Interrogez toutes les 3 à 5 secondes et arrêtez dès que le statut est succeeded ou failed. Les images prennent en général de quelques secondes à quelques minutes ; si une tâche est encore en processing après 10 minutes, arrêtez et contactez le support avec son task_id. Quand la tâche réussit, output.images contient les URL des images ; téléchargez-les si vous voulez les conserver.

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"
  }
}

Statut de la tâche

processing

La tâche est en cours ou attend la confirmation du débit ou de son acceptation par le fournisseur.

succeeded

Terminé. output.images contient les résultats et credits_charged est définitif.

failed

La génération a échoué et error.message en explique la raison. Les crédits débités sont remboursés automatiquement : refund_pending vaut true jusqu'au remboursement, puis credits_charged indique 0. Vous pouvez arrêter d'interroger.

// 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)

Tarifs

Les prix sont en crédits et correspondent exactement au site. 1 crédit vaut US$0.01. Chaque image de référence ajoute un petit montant. GET /api/v1/models renvoie toujours la grille tarifaire actuelle.

Erreurs

Les erreurs utilisent le code de statut HTTP et la même structure JSON : code, message, error_type et data.

Limites et bonnes pratiques

• Chaque clé a une limite par minute et une limite de tâches en cours. Les offres payantes ont des limites plus élevées.
• Envoyez un en-tête Idempotency-Key à chaque requête de création. Si une requête expire, renvoyez-la avec le même Idempotency-Key : vous obtenez la même tâche et n'êtes jamais facturé deux fois.
• Les images de référence doivent être accessibles depuis l'internet public. Les URL signées conviennent si elles restent valides quelques minutes.
• Les tâches sont privées. Une clé ne peut lire que les tâches qu'elle a créées.

Questions fréquentes