Flux الٹرا ریزولوشن

انتہائی تفصیل اور ریزولوشن کے ساتھ زیادہ سے زیادہ کوالٹی کی تصاویر۔

✓ 4K ریزولوشن

✓ انتہائی تفصیل

✓ RAW کوالٹی

✓ پروفیشنل آؤٹ پٹ

تصدیق

Doitong API کے ذریعے Flux Ultra تک رسائی حاصل کرنے کے لیے، اپنی Doitong API کی (key) استعمال کریں۔ اسے GraphQL میوٹیشن یا REST API ہیڈرز میں شامل کریں۔

اہم نوٹ: اپنی Doitong API کی کو محفوظ رکھیں اور اسے کبھی بھی کلائنٹ سائیڈ کوڈ میں ظاہر نہ کریں۔ ہمیشہ اپنے بیک اینڈ سرور سے API کالز کریں۔
// GraphQL Header
{
  "Authorization": "Bearer YOUR_API_KEY"
}

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

فوری آغاز

صرف چند منٹوں میں Flux Ultra 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-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 کریڈٹ پر مبنی قیمتوں کا ماڈل استعمال کرتا ہے۔ کریڈٹس کا استعمال تیار کردہ مواد کی پیچیدگی اور دورانیے کی بنیاد پر کیا جاتا ہے۔

فیچر کریڈٹس تفصیل
معیاری ریزولوشن 10-20 کریڈٹس 512x512 سے 1024x1024 پکسلز
ہائی ریزولوشن 30-50 کریڈٹس 2048x2048 پکسلز اور اس سے اوپر

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 کی درخواستوں کے لیے دستیاب پیرامیٹرز:

پیرامیٹر قسم ضروری تفصیل
service String Yes سروس آئیڈنٹیفائر: "flux-ultra"
prompt String Yes جو کچھ تیار کرنا ہے اس کی تحریری وضاحت
width Integer No پکسلز میں تصویر کی چوڑائی (ڈیفالٹ: 1024)
height Integer No پکسلز میں تصویر کی اونچائی (ڈیفالٹ: 1024)
version String No Model version: "flux-pro-1.1-ultra"
webhookUrl String No تکمیل کی اطلاعات موصول کرنے کے لیے URL

جواب کا فارمیٹ

تمام 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 اسٹیٹس کوڈز استعمال کرتا ہے اور تفصیلی غلطی کے پیغامات فراہم کرتا ہے۔

عام ایرر کوڈز

اسٹیٹس کوڈ ایرر کی قسم تفصیل
400 Bad Request Invalid parameters or malformed request
401 Unauthorized Missing or invalid API key
402 Payment Required Insufficient credits
429 Too Many Requests Rate limit exceeded
500 Internal Server Error Server error, please retry

ایرر رسپانس فارمیٹ

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

ریٹ لمٹس

منصفانہ استعمال اور سسٹم کے استحکام کو یقینی بنانے کے لیے، درج ذیل ریٹ لمٹس لاگو ہوتی ہیں:

پلان درخواستیں فی منٹ ایک ساتھ چلنے والے کام روزانہ کی حد
مفت 10 1 100
اسٹارٹر 30 3 1,000
پرو 60 10 10,000
انٹرپرائز کسٹم کسٹم لامحدود
ریٹ لمٹ ہیڈرز: موجودہ لمٹ کی صورتحال کے لیے رسپانس ہیڈرز چیک کریں:
  • X-RateLimit-Limit: Maximum requests per window
  • X-RateLimit-Remaining: Requests remaining
  • X-RateLimit-Reset: Window reset timestamp

بہترین طریقے

1. اپنے پرامپٹس کو بہتر بنائیں

بہترین نتائج کے لیے واضح اور وضاحتی پرامپٹس لکھیں:

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

2. غیر مطابقت پذیر (Async) پروسیسنگ سنبھالیں

مواد کی تیاری غیر مطابقت پذیر ہوتی ہے۔ مناسب پولنگ یا ویب ہکس نافذ کریں:

// 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. ایرر ریکوری

ایکسپونینشل بیک آف کے ساتھ دوبارہ کوشش (retry) کی لاجک نافذ کریں:

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 Ultra API استعمال کرنے والے ہزاروں ڈویلپرز میں شامل ہوں

API کی حاصل کریں قیمتیں دیکھیں