Reve Art

Reve Art API Dokümantasyonu

Reve Art'ın resim oluşturma API'sine hoş geldiniz. Hizmet, basit bir REST API aracılığıyla son teknoloji ürünü, yapay zeka destekli resim oluşturma yetenekleri sunar.

Reve Image 1.0'a Giriş

Reve Image 1.0, aşağıdakilere odaklanarak tasarlanmış amiral gemisi metinden resim oluşturma modelimizdir:

  • Üstün istem uyumu
  • Yüksek estetik kalite
  • Doğru tipografi oluşturma
  • Sezgisel metinden resme oluşturma

Model, gelişmiş istem mühendisliği uzmanlığı gerektirmeden yüksek kaliteli sonuçlar üretmek üzere tasarlanmıştır, bu da onu hem yeni başlayanlar hem de deneyimli kullanıcılar için erişilebilir hale getirir. Resim Oluştur adresinden ücretsiz deneyebilirsiniz.

Kullanım Alanları

Reve Art API, çeşitli uygulamalara entegre edilebilir:

  • İçerik Oluşturma: Bloglar, makaleler ve sosyal medya için benzersiz görseller oluşturun
  • E-ticaret: Ürün maketleri ve varyasyonları oluşturun
  • Tasarım ve Prototip Oluşturma: Tasarım konseptlerini hızlı bir şekilde görselleştirin
  • Oyun ve Eğlence: Oyun varlıkları ve karakter tasarımları oluşturun
  • Eğitim: Eğitim materyalleri ve çizimler oluşturun

Kimlik Doğrulama

Tüm API istekleri, bir API anahtarı kullanılarak kimlik doğrulaması gerektirir.

API anahtarını Yetkilendirme başlığına ekleyin:

curl -X POST https://reve-art.com/v1/reve-image/generate \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{"prompt": "buraya isteminiz", "aspect_ratio": "1:1"}'

API Anahtarı Nasıl Alınır

Lütfen oturum açın ve API anahtarınızı Kontrol Paneli > API Anahtarları sayfasında ekleyin.

Ardından, resim oluşturmak için API anahtarını kullanın.

Resim Oluştur

Resim oluşturma uç noktası, metin açıklamalarından resimler oluşturmanıza olanak tanır. Oluşturma sürecinin çeşitli yönlerini parametrelerle kontrol edebilirsiniz.

En İyi Uygulamalar

  1. İstem Mühendisliği

    • İstemlerinizde belirli ve açıklayıcı olun
    • Stil rehberliği için sanatsal terimler kullanın
    • Aydınlatma, perspektif ve ruh hali hakkında ayrıntılar ekleyin

  2. En Boy Oranı Seçimi

    • Amaçlanan kullanım durumunuza göre seçin
    • Sosyal medya gönderileri için 1:1
    • Sunumlar/afişler için 16:9
    • Mobil içerik için 9:16

  3. Eşzamansız Oluşturma

    • Daha uzun oluşturmalar için async=true kullanın
    • Daha iyi bir kullanıcı deneyimi için durum yoklaması uygulayın

POST /v1/images/generate

İstek Gövdesi

{
  "prompt": "string",           // Gerekli: Resim oluşturma istemi
  "negative_prompt": "string",  // İsteğe bağlı: Resimde kaçınılması gereken şeyler
  "aspect_ratio": "string",    // Gerekli: Resim en boy oranı (varsayılan: "1:1")
  "async": boolean             // İsteğe bağlı: Eşzamansız oluşturma (varsayılan: false)
}

En Boy Oranı

Resmin en boy oranı. Desteklenen oranlar: "1:1", "16:9", "4:3", "3:4", "9:16", "2:3", "3:2".

Eşzamanlı Yanıt

{
  "id": "img_123",
  "status": "completed",
  "url": "https://cdn.reve-art.com/img_123.png",
  "metadata": {
    "prompt": "isteminiz",
    "width": 1024,
    "height": 1024,
    "created_at": "2024-01-01T00:00:00Z"
  }
}

Eşzamansız Yanıt

{
  "id": "img_123",
  "status": "pending"
}

Örnek Kullanım

Python:

import requests

api_key = "your_api_key"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.reve-art.com/v1/reve-image/generate",
    headers=headers,
    json={
        "prompt": "dağlar üzerinde güzel bir gün batımı",
        "aspect_ratio": "16:9"
    }
)

if response.ok:
    result = response.json()
    print(f"Resim URL'si: {result['url']}")
else:
    print(f"Hata: {response.text}")

Node.js:

async function generateImage(prompt: string) {
  const response = await fetch("https://api.reve-art.com/v1/reve-image/generate", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt,
      aspect_ratio: "1:1",
      async: true,
    }),
  });

  if (!response.ok) {
    throw new Error(`Resim oluşturma başarısız: ${response.statusText}`);
  }

  const result = await response.json();
  
  if (result.status === "pending") {
    // Tamamlanma için yoklama
    return await checkImageStatus(result.id);
  }

  return result;
}

Resim Durumunu Kontrol Et

GET /v1/reve-image/status/image_id

Yanıt

{
  "id": "img_123",
  "status": "completed",
  "url": "https://cdn.reve-art.com/img_123.png",
  "metadata": {
    "prompt": "orijinal istem",
    "width": 1024,
    "height": 1024,
    "model": "text2image_v1",
    "created_at": "2024-01-01T00:00:00Z"
  }
}

Örnek Kullanım

async function checkImageStatus(imageId: string) {
  const response = await fetch(
    `https://reve-art.com/v1/reve-image/status/${imageId}/`,
    {
      headers: {
        "Authorization": `Bearer ${apiKey}`,
      },
    }
  );

  if (!response.ok) {
    throw new Error(`Durum kontrolü başarısız: ${response.statusText}`);
  }

  return await response.json();
}

Oran Sınırlamaları

API istekleri, abonelik planınız ve mevcut kredileriniz ile sınırlıdır.