Flux আল্ট্রা রেজোলিউশন

চরম ডিটেইল এবং রেজোলিউশন সহ সর্বোচ্চ কোয়ালিটির ইমেজ।

অথেন্টিকেশন

Doitong API-এর মাধ্যমে Flux Ultra ব্যবহার করতে আপনার Doitong API কী (key) ব্যবহার করুন। এটি GraphQL মিউটেশন বা REST API হেডারে অন্তর্ভুক্ত করুন।

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

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

দ্রুত শুরু করুন

মাত্র কয়েক মিনিটে Flux Ultra API-এর সাথে কাজ শুরু করুন। আপনার প্রথম text to image তৈরি করতে এই সহজ ধাপগুলো অনুসরণ করুন।

ধাপ ১: আপনার API কী সংগ্রহ করুন

একটি Doitong অ্যাকাউন্টে সাইন আপ করুন এবং API কী তৈরি করতে আপনার ড্যাশবোর্ডে যান।

ধাপ ২: আপনার প্রথম রিকোয়েস্ট পাঠান

আপনার প্রথম 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-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"
    }
  }
}

মূল্যতালিকা

Flux Ultra API একটি ক্রেডিট-ভিত্তিক মূল্য মডেল ব্যবহার করে। তৈরি করা কন্টেন্টের জটিলতা এবং দৈর্ঘ্যের ওপর ভিত্তি করে ক্রেডিট খরচ হয়।

API এন্ডপয়েন্ট

Flux Ultra API আমাদের ইউনিফাইড GraphQL এন্ডপয়েন্টের মাধ্যমে উপলব্ধ।

GraphQL এন্ডপয়েন্ট

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

REST এন্ডপয়েন্ট

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

প্যারামিটার

Flux Ultra 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 তৈরি সম্পন্ন হলে রিয়েল-টাইম নোটিফিকেশন পান।

ওয়েব হুক সেটআপ

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

ওয়েব হুক পেলোড

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

ওয়েব হুক নিরাপত্তা

যাচাইকরণের জন্য সব ওয়েব হুক রিকোয়েস্টে একটি সিগনেচার হেডার থাকে:

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

রেট লিমিট

সঠিক ব্যবহার এবং সিস্টেমের স্থায়িত্ব নিশ্চিত করতে নিচের রেট লিমিটগুলো প্রযোজ্য:

সেরা অনুশীলন

১. আপনার প্রম্পট অপ্টিমাইজ করুন

সেরা ফলাফলের জন্য স্পষ্ট এবং বর্ণনামূলক প্রম্পট লিখুন:

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

২. অ্যাসিঙ্ক প্রসেসিং হ্যান্ডেল করুন

কন্টেন্ট তৈরি একটি অ্যাসিঙ্ক্রোনাস প্রক্রিয়া। সঠিক পোলিং বা ওয়েব হুক ব্যবহার করুন:

// 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;
}

৩. এরর রিকভারি

এক্সপোনেনশিয়াল ব্যাকঅফ সহ রিট্রাই লজিক ইমপ্লিমেন্ট করুন:

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);
    }
  }
}

৪. ক্রেডিট ব্যবহার মনিটর করুন

বিঘ্ন এড়াতে আপনার ক্রেডিট খরচ ট্র্যাক করুন:

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

শুরু করতে প্রস্তুত?

চমৎকার কন্টেন্ট তৈরি করতে Flux Ultra API ব্যবহারকারী হাজার হাজার ডেভেলপারদের সাথে যোগ দিন