Flux Professional Images

Profesionāla attēlu ģenerēšana ar izcilu kvalitāti un detalizāciju.

Autentifikācija

Lai piekļūtu Flux Pro, izmantojot Doitong API, lietojiet savu Doitong API atslēgu. Iekļaujiet to GraphQL mutācijā vai REST API galvenēs (headers).

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

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

Ātrais darba sākums

Sāciet lietot Flux Pro API dažu minūšu laikā. Izpildiet šos vienkāršos soļus, lai ģenerētu savu pirmo text to image.

1. solis: Saņemiet API atslēgu

Reģistrējieties Doitong kontam un dodieties uz vadības paneli, lai izveidotu API atslēgu.

2. solis: Veiciet pirmo pieprasījumu

Izmantojiet kādu no zemāk redzamajiem koda piemēriem, lai veiktu savu pirmo API izsaukumu.

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-pro",
        "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-pro',
        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-pro",
        "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-pro",
    "input": {
      "text": "A futuristic city with flying cars and neon lights"
    },
    "options": {
      "width": 1024,
      "height": 1024,
      "version": "flux-pro-1.1",
      "quality": "high"
    }
  }
}

Cenas

Flux Pro API izmanto kredītpunktu cenu modeli. Kredīti tiek patērēti atkarībā no ģenerētā satura sarežģītības un ilguma.

API galapunkti

Flux Pro API ir pieejams caur mūsu vienoto GraphQL galapunktu.

GraphQL galapunkts

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

REST galapunkts

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

Parametri

Pieejamie parametri Flux Pro API pieprasījumiem:

Atbildes formāts

Visas API atbildes tiek sniegtas vienotā formātā:

Sekmīga atbilde

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

Pabeigta darbība

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

Kļūdu apstrāde

API izmanto standarta HTTP statusa kodus un atgriež detalizētus kļūdu ziņojumus.

Biežākie kļūdu kodi

Kļūdas atbildes formāts

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

Webhooks

Saņemiet reāllaika paziņojumus, kad jūsu text to image ģenerēšana ir pabeigta.

Webhook iestatīšana

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

Webhook dati (payload)

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

Webhook drošība

Visi Webhook pieprasījumi ietver paraksta galveni verifikācijai:

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

Pieprasījumu ierobežojumi

Lai nodrošinātu godīgu lietošanu un sistēmas stabilitāti, tiek piemēroti šādi ierobežojumi:

Labā prakse

1. Optimizējiet uzvednes (prompts)

Rakstiet skaidras un aprakstošas uzvednes labākiem rezultātiem:

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

2. Apstrādājiet asinhronos procesus

Ģenerēšana ir asinhrona. Ieviesiet atbilstošu aptauju (polling) vai 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. Kļūdu novēršana

Ieviesiet atkārtošanas loģiku ar eksponenciālo atpakaļatkāpi (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. Uzraugiet kredītu patēriņu

Sekojiet līdzi kredītu atlikumam, lai izvairītos no pakalpojuma pārtraukumiem:

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

Vai esat gatavs sākt?

Pievienojieties tūkstošiem izstrādātāju, kuri izmanto Flux Pro API, lai radītu pārsteidzošu saturu