Flux Development Model API

Fast development model for quick iterations and prototyping

אָטענטיפֿיקאַציע

כדי צוצוטרעטן צו Flux Dev API דורך דעם Doitong API, ניצט אייער Doitong API שליסל. לייגט אים אַרײַן אין די GraphQL mutation אָדער REST API headers.

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

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

שנעלער אָנהייב

הייבט אָן ניצן Flux Dev 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-dev",
        "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-dev',
        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-dev",
        "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-dev",
    "input": {
      "text": "A futuristic city with flying cars and neon lights"
    },
    "options": {
      "width": 1024,
      "height": 1024,
      "version": "flux-dev",
      "quality": "high"
    }
  }
}

פּרייזן

Flux Dev API ניצט אַ מאָדעל פֿון פּרייזן באזירט אויף קרעדיטן. קרעדיטן ווערן פֿאַרנוצט לויט דער קאָמפּליצירטקייט און לענג פֿון דעם גענערירטן אינהאַלט.

API ענדפּונקטן

Flux Dev API איז בנימצא דורך אונדזער פֿאַראייניקטן GraphQL ענדפּונקט.

GraphQL ענדפּונקט

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

REST ענדפּונקט

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

פּאַראַמעטערס

בנימצאדיקע פּאַראַמעטערס פֿאַר Flux Dev 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-dev",
  "createdAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:01:00Z",
  "metadata": {
    "duration": null,
    "width": 1920,
    "height": 1080
  }
}

וועבהוק זיכערקייט

אַלע וועבהוק בקשות פֿאַרמאָגן אַ חתימה-העדער (signature header) פֿאַר באַשטעטיקונג:

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

ראַטע-לימיטן

כדי צו פֿאַרזיכערן אַ יושרדיקע באַניצונג און סיסטעם-סטאַביליטעט, גילטן די פֿאָלגנדע לימיטן:

בעסטע מעטאָדן

1. אָפּטימיזירט אייערע פּראָמפּטס

שרײַבט קלאָרע, דעטאַלירטע פּראָמפּטס פֿאַר די בעסטע רעזולטאַטן:

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

2. באַהאַנדלט אַסינכראָנישע פּראָצעסירונג

די גענערירונג איז אַסינכראָניש. ניצט פּאַסיקע פּאָלינג (polling) אָדער וועבהוקס:

// 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. ערהוילונג פֿון פֿעלערן

ניצט אַ לאָגיק פֿון איבערפּרוּוון מיט עקספּאָנענציעלן צוריקטרעט (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. קאָנטראָלירט קרעדיט-באַניצונג

האַלט אַן אויג אויף אייער פֿאַרברויך פֿון קרעדיטן צו פֿאַרמײַדן איבעררײַסן:

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

גרייט אָנצוהייבן?

פֿאַרבינדט זיך מיט טויזנטער דעוועלאָפּערס וואָס ניצן Flux Dev API צו שאַפֿן מוראדיקן אינהאַלט