Resolusi Flux Ultra

Imej kualiti maksimum dengan perincian dan resolusi ekstrem.

Pengesahan

Untuk mengakses Flux Ultra melalui API Doitong, gunakan kunci API Doitong anda. Sertakannya dalam mutasi GraphQL atau pengepala API REST.

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

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

Mula Pantas

Mulakan dengan Flux Ultra API dalam masa beberapa minit sahaja. Ikuti langkah mudah ini untuk menjana text to image pertama anda.

Langkah 1: Dapatkan Kunci API Anda

Daftar akaun Doitong dan pergi ke papan pemuka anda untuk menjana kunci API.

Langkah 2: Buat Permintaan Pertama Anda

Gunakan salah satu contoh kod di bawah untuk membuat panggilan API pertama anda.

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

Harga

Flux Ultra API menggunakan model harga berasaskan kredit. Kredit ditolak berdasarkan kerumitan dan tempoh kandungan yang dijana.

Titik Akhir API

Flux Ultra API tersedia melalui titik akhir GraphQL kami yang bersatu.

Titik Akhir GraphQL

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

Titik Akhir REST

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

Parameter

Parameter yang tersedia untuk permintaan Flux Ultra API:

Format Respons

Semua respons API mengikut format yang konsisten:

Respons Berjaya

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

Respons Selesai

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

Pengendalian Ralat

API ini menggunakan kod status HTTP standard dan mengembalikan mesej ralat yang terperinci.

Kod Ralat Biasa

Format Respons Ralat

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

Webhook

Terima pemberitahuan masa nyata apabila penjanaan text to image anda selesai.

Menetapkan Webhook

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-ultra",
  "createdAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:01:00Z",
  "metadata": {
    "duration": null,
    "width": 1920,
    "height": 1080
  }
}

Keselamatan Webhook

Semua permintaan webhook menyertakan pengepala tandatangan untuk pengesahan:

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

Had Kadar

Untuk memastikan penggunaan yang adil dan kestabilan sistem, had kadar berikut dikenakan:

Amalan Terbaik

1. Optimumkan Gesaan Anda

Tulis gesaan yang jelas dan deskriptif untuk hasil terbaik:

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

2. Kendalikan Pemprosesan Asinkron

Penjanaan adalah asinkron. Laksanakan 'polling' atau webhook yang betul:

// 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. Pemulihan Ralat

Laksanakan logik cuba semula dengan 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. Pantau Penggunaan Kredit

Jejaki penggunaan kredit anda untuk mengelakkan gangguan perkhidmatan:

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

Bersedia untuk Bermula?

Sertai beribu-ribu pembangun yang menggunakan Flux Ultra API untuk mencipta kandungan yang menakjubkan