Flux Kontext Context-Aware API

Specialized for context-aware generation with style control

Xác thực

Để truy cập Flux Kontext API thông qua Doitong API, hãy sử dụng mã API (API key) của bạn. Hãy đính kèm mã này vào mutation GraphQL hoặc header của REST API.

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

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

Bắt đầu nhanh

Bắt đầu với Flux Kontext API chỉ trong vài phút. Làm theo các bước đơn giản sau để tạo text to image đầu tiên của bạn.

Bước 1: Lấy mã API

Đăng ký tài khoản Doitong và đi tới bảng điều khiển để tạo mã API.

Bước 2: Thực hiện yêu cầu đầu tiên

Sử dụng một trong các ví dụ mã dưới đây để thực hiện lệnh gọi API đầu tiên.

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

Bảng giá

Flux Kontext API sử dụng mô hình tính phí theo tín dụng (credit). Tín dụng sẽ được tiêu thụ dựa trên độ phức tạp và thời lượng của nội dung được tạo.

Điểm cuối API

Flux Kontext API khả dụng thông qua điểm cuối GraphQL hợp nhất của chúng tôi.

Điểm cuối GraphQL

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

Điểm cuối REST

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

Tham số

Các tham số khả dụng cho yêu cầu Flux Kontext API:

Định dạng phản hồi

Tất cả phản hồi API đều tuân theo một định dạng nhất quán:

Phản hồi thành công

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

Phản hồi hoàn tất

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

Xử lý lỗi

API sử dụng các mã trạng thái HTTP tiêu chuẩn và trả về thông báo lỗi chi tiết.

Các mã lỗi phổ biến

Định dạng phản hồi lỗi

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

Webhooks

Nhận thông báo theo thời gian thực khi quá trình tạo text to image của bạn hoàn tất.

Thiết lập Webhooks

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

Dữ liệu Webhook (Payload)

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

Bảo mật Webhook

Tất cả các yêu cầu webhook đều bao gồm một header chữ ký để xác thực:

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

Giới hạn tốc độ

Để đảm bảo sử dụng công bằng và ổn định hệ thống, các giới hạn tốc độ sau sẽ được áp dụng:

Lời khuyên hữu ích

1. Tối ưu hóa câu lệnh (Prompt)

Viết các câu lệnh rõ ràng, chi tiết để có kết quả tốt nhất:

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

2. Xử lý bất đồng bộ

Quá trình tạo là bất đồng bộ. Hãy triển khai cơ chế polling hoặc webhook phù hợp:

// 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. Khôi phục lỗi

Triển khai logic thử lại (retry) với khoảng thời gian chờ tăng dần (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. Theo dõi mức sử dụng tín dụng

Theo dõi lượng tiêu thụ tín dụng của bạn để tránh bị gián đoạn:

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

Sẵn sàng bắt đầu?

Tham gia cùng hàng ngàn nhà phát triển đang sử dụng Flux Kontext API để tạo ra nội dung tuyệt vời