Minimax Görsel Oluşturma API'si

Mükemmel sanatsal anlayışa sahip gelişmiş Çin menşeli model.

Kimlik Doğrulama

Minimax Görsel platformuna Doitong API üzerinden erişmek için Doitong API anahtarınızı kullanın. Bu anahtarı GraphQL mutasyonuna veya REST API başlıklarına ekleyin.

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

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

Hızlı Başlangıç

Minimax Image API ile birkaç dakika içinde başlayın. İlk text to image içeriğinizi oluşturmak için bu basit adımları izleyin.

1. Adım: API Anahtarınızı Alın

Bir Doitong hesabı oluşturun ve API anahtarı oluşturmak için panelinize gidin.

2. Adım: İlk İsteğinizi Gönderin

İlk API çağrınızı yapmak için aşağıdaki kod örneklerinden birini kullanı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": "minimax-image",
        "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: 'minimax-image',
        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": "minimax-image",
        "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": "minimax-image",
    "input": {
      "text": "A futuristic city with flying cars and neon lights"
    },
    "options": {
      "width": 1024,
      "height": 1024,
      "version": "minimax-v1",
      "quality": "high"
    }
  }
}

Fiyatlandırma

Minimax Image API, kredi tabanlı bir fiyatlandırma modeli kullanır. Krediler, oluşturulan içeriğin karmaşıklığına ve süresine göre tüketilir.

API Uç Noktaları

Minimax Image API hizmetine birleşik GraphQL uç noktamız üzerinden erişilebilir.

GraphQL Uç Noktası

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

REST Uç Noktası

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

Parametreler

Minimax Image API istekleri için kullanılabilir parametreler:

Yanıt Formatı

Tüm API yanıtları tutarlı bir format izler:

Başarılı Yanıt

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

Tamamlanmış Yanıt

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

Hata Yönetimi

API, standart HTTP durum kodlarını kullanır ve ayrıntılı hata mesajları döndürür.

Yaygın Hata Kodları

Hata Yanıt Formatı

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

Webhook'lar

text to image oluşturma işleminiz tamamlandığında gerçek zamanlı bildirimler alın.

Webhook Kurulumu

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

Webhook Verisi (Payload)

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

Webhook Güvenliği

Tüm webhook istekleri doğrulama için bir imza başlığı içerir:

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

İstek Limitleri

Adil kullanım ve sistem kararlılığını sağlamak için aşağıdaki limitler geçerlidir:

En İyi Uygulamalar

1. Komutlarınızı Optimize Edin

En iyi sonuçlar için net ve açıklayıcı komutlar (prompt) yazın:

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

2. Asenkron İşlemleri Yönetin

Oluşturma işlemi asenkrondur. Uygun sorgulama (polling) veya webhook mekanizmalarını kurun:

// 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. Hata Kurtarma

Üstel geri çekilme (exponential backoff) ile yeniden deneme mantığını uygulayın:

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. Kredi Kullanımını İzleyin

Kesinti yaşamamak için kredi tüketiminizi takip edin:

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

Başlamaya Hazır mısınız?

Harika içerikler oluşturmak için Minimax Image API kullanan binlerce geliştiriciye katılın