Flux Krea Optimized API

Βελτιστοποιημένη υλοποίηση Flux με πολλαπλά επίπεδα ποιότητας.

Ταυτοποίηση

Για να αποκτήσετε πρόσβαση στο Flux Krea μέσω του Doitong API, χρησιμοποιήστε το κλειδί API της Doitong. Συμπεριλάβετε το στο GraphQL mutation ή στα headers του REST API.

// GraphQL Header
{
  "Authorization": "Bearer YOUR_API_KEY"
}

// REST Header
"X-API-Key": "YOUR_API_KEY"

Γρήγορη εκκίνηση

Ξεκινήστε με το Flux Krea API σε λίγα μόλις λεπτά. Ακολουθήστε αυτά τα απλά βήματα για να δημιουργήσετε το πρώτο σας text to image.

Βήμα 1: Αποκτήστε το κλειδί API

Εγγραφείτε για έναν λογαριασμό Doitong και μεταβείτε στο ταμπλό σας για να δημιουργήσετε ένα κλειδί API.

Βήμα 2: Κάντε το πρώτο σας αίτημα

Χρησιμοποιήστε ένα από τα παρακάτω παραδείγματα κώδικα για να πραγματοποιήσετε την πρώτη σας κλήση API.

curl -X POST https://api.doitong.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "query": "mutation Generate($input: GenerateInput!) { generate(input: $input) { id status type provider url metadata creditCost } }",
    "variables": {
      "input": {
        "type": "IMAGE",
        "provider": "flux-krea",
        "input": {
          "text": "A futuristic city with flying cars and neon lights"
        },
        "options": {
          "width": 1024,
          "height": 1024
        }
      }
    }
  }'

const response = await fetch('https://api.doitong.com/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    query: `
      mutation GenerateImage($input: ImageGenerationInput!) {
        generateImage(input: $input) {
          id
          url
          width
          height
        }
      }
    `,
    variables: {
      input: {
        service: 'flux-krea',
        prompt: 'A futuristic city with flying cars and neon lights',
        width: 1024,
        height: 1024
      }
    }
  })
});

const data = await response.json();
console.log('Image:', data.data.generateImage);

import requests
import json

url = "https://api.doitong.com/graphql"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

query = """
mutation Generate($input: GenerateInput!) {
  generate(input: $input) {
    id
    status
    type
    provider
    url
    metadata
    creditCost
  }
}
"""

variables = {
    "input": {
        "type": "IMAGE",
        "provider": "flux-krea",
        "input": {
            "text": "A futuristic city with flying cars and neon lights"
        },
        "options": {
            "width": 1024,
            "height": 1024
        }
    }
}

response = requests.post(url, json={
    "query": query,
    "variables": variables
}, headers=headers)

data = response.json()
print("Result:", data["data"]["generate"])

mutation Generate($input: GenerateInput!) {
  generate(input: $input) {
    id
    status
    type
    provider
    url
    metadata
    creditCost
    createdAt
  }
}

# Variables
{
  "input": {
    "type": "IMAGE",
    "provider": "flux-krea",
    "input": {
      "text": "A futuristic city with flying cars and neon lights"
    },
    "options": {
      "width": 1024,
      "height": 1024,
      "version": "flux-krea",
      "quality": "high"
    }
  }
}

Τιμολόγηση

Το Flux Krea API χρησιμοποιεί ένα μοντέλο τιμολόγησης βάσει πιστώσεων. Οι πιστώσεις καταναλώνονται ανάλογα με την πολυπλοκότητα και τη διάρκεια του περιεχομένου που δημιουργείται.

Endpoints API

Το Flux Krea API είναι διαθέσιμο μέσω του ενοποιημένου GraphQL endpoint μας.

GraphQL Endpoint

POST https://api.doitong.com/graphql

REST Endpoint

POST https://api.doitong.com/v1/text_to_image

Παράμετροι

Διαθέσιμες παράμετροι για αιτήματα Flux Krea API:

Μορφή απόκρισης

Όλες οι αποκρίσεις του API ακολουθούν μια σταθερή μορφή:

Απόκριση επιτυχίας

{
  "data": {
    "generateimage": {
      "id": "abc123xyz",
      "status": "processing",
      "url": null,
      "webhookUrl": "https://your-webhook.com/callback",
      "createdAt": "2024-01-01T00:00:00Z"
    }
  }
}

Απόκριση ολοκλήρωσης

{
  "data": {
    "generateimage": {
      "id": "abc123xyz",
      "status": "completed",
      "url": "https://cdn.doitong.com/outputs/abc123xyz.jpg",
      "duration": null,
      "createdAt": "2024-01-01T00:00:00Z"
    }
  }
}

Διαχείριση σφαλμάτων

Το API χρησιμοποιεί τυπικούς κωδικούς κατάστασης HTTP και επιστρέφει λεπτομερή μηνύματα σφαλμάτων.

Κοινοί κωδικοί σφαλμάτων

Μορφή απόκρισης σφάλματος

{
  "errors": [
    {
      "message": "Insufficient credits for this operation",
      "extensions": {
        "code": "INSUFFICIENT_CREDITS",
        "creditsRequired": 100,
        "creditsAvailable": 50
      }
    }
  ]
}

Webhooks

Λάβετε ειδοποιήσεις σε πραγματικό χρόνο όταν ολοκληρωθεί η δημιουργία του text to image.

Ρύθμιση Webhooks

Include a <code>webhookUrl</code> parameter in your request to receive a POST notification when processing is complete.

Payload Webhook

{
  "id": "abc123xyz",
  "status": "completed",
  "url": "https://cdn.doitong.com/outputs/abc123xyz.jpg",
  "service": "flux-krea",
  "createdAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:01:00Z",
  "metadata": {
    "duration": null,
    "width": 1920,
    "height": 1080
  }
}

Ασφάλεια Webhook

Όλα τα αιτήματα webhook περιλαμβάνουν μια κεφαλίδα υπογραφής για επαλήθευση:

X-Doitong-Signature: sha256=abc123...

Όρια ρυθμού

Για τη διασφάλιση της δίκαιης χρήσης και της σταθερότητας του συστήματος, ισχύουν τα ακόλουθα όρια:

Βέλτιστες πρακτικές

1. Βελτιστοποιήστε τα Prompts σας

Γράψτε σαφή και περιγραφικά prompts για καλύτερα αποτελέσματα:

• Be specific about visual elements, style, and mood
• Include details about lighting, camera angles, and composition
• Avoid contradictory or impossible requests

2. Διαχείριση ασύγχρονης επεξεργασίας

Η δημιουργία είναι ασύγχρονη. Εφαρμόστε κατάλληλο polling ή webhooks:

// Polling example
async function pollStatus(jobId) {
  let status = 'processing';
  while (status === 'processing') {
    await sleep(2000); // Wait 2 seconds
    const result = await checkJobStatus(jobId);
    status = result.status;
  }
  return result;
}

3. Ανάκτηση από σφάλματα

Εφαρμόστε λογική επαναπροσπάθειας με εκθετική καθυστέρηση (exponential backoff):

async function retryWithBackoff(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      await sleep(Math.pow(2, i) * 1000);
    }
  }
}

4. Παρακολούθηση χρήσης πιστώσεων

Παρακολουθήστε την κατανάλωση των πιστώσεών σας για να αποφύγετε διακοπές:

• Check credit balance before large batch operations
• Set up alerts for low credit thresholds
• Implement credit-aware request queuing

Είστε έτοιμοι να ξεκινήσετε;

Γίνετε μέλος χιλιάδων προγραμματιστών που χρησιμοποιούν το Flux Krea API για να δημιουργήσουν εκπληκτικό περιεχόμενο