Blog
Bakış Açısı

API ile HiDream-I1 Görüntü Oluşturmayı Nasıl Test Ederim?

Her hafta yeni, çarpıcı görseller üreten yapay zeka modelleri çıkıyor. HiDream-I1-Full gibi. API'ler, entegrasyonu kolaylaştırır.

Efe Demir

Efe Demir

5 June 2025

API ile HiDream-I1 Görüntü Oluşturmayı Nasıl Test Ederim?

Görünüşe göre her hafta, çarpıcı görseller oluşturabilen yeni bir Yapay Zeka Görüntü Oluşturma modeli elde ediyoruz. Bu güçlü modellerden biri de HiDream-I1-Full. Bu modelleri yerel olarak çalıştırmak kaynak yoğun olabilirken, API'lerden yararlanmak, bu teknolojiyi uygulamalarınıza veya iş akışlarınıza entegre etmenin kullanışlı ve ölçeklenebilir bir yolunu sunar.

Bu eğitim size şunları gösterecektir:

  1. HiDream-I1-Full'u Anlamak: Neyin nesi ve yetenekleri.
  2. API Seçenekleri: HiDream-I1-Full'u API aracılığıyla sunan iki popüler platformu keşfetmek: Replicate ve Fal.ai.
  3. Apidog ile Test Etme: Apidog aracını kullanarak bu API'lerle nasıl etkileşim kuracağınız ve bunları nasıl test edeceğinize dair adım adım bir kılavuz.
💡
Harika API Dokümantasyonu oluşturan harika bir API Test aracı mı istiyorsunuz?

Maksimum verimlilikle birlikte çalışmak için Geliştirici Ekibiniz için entegre, Hepsi Bir Arada bir platform mu istiyorsunuz?

Apidog tüm taleplerinizi karşılıyor ve Postman'in yerini çok daha uygun bir fiyata alıyor!
button

Hedef Kitle: Geliştiriciler, tasarımcılar, Yapay Zeka meraklıları ve karmaşık yerel kurulumlar olmadan gelişmiş Yapay Zeka görüntü oluşturma kullanmakla ilgilenen herkes.

Önkoşullar:

HiDream-I1-Full Nedir?

HiDream AI: Yapay Zeka Görüntü Oluşturmanın Yeni Kralı mı?

HiDream-I1-Full, HiDream AI tarafından geliştirilen gelişmiş bir metinden görüntüye yayılım modelidir. Metinsel açıklamalara (istemlere) dayalı olarak yüksek kaliteli, tutarlı ve estetik açıdan hoş görüntüler oluşturmak üzere tasarlanmış model ailesine aittir.

Model Detayları: Resmi model kartını ve daha fazla teknik bilgiyi Hugging Face'de bulabilirsiniz: https://huggingface.co/HiDream-ai/HiDream-I1-Full

Temel Yetenekler (Bu sınıfın modelleri için tipik):

HiDream AI'nin GOT-4o, Recraft V3, Google Image 3, Ideogram 3.0 ve FLUX ile Karşılaştırmalı Ölçütleri (Kaynak: ArtificialAnalysis)

Neden API Kullanmalısınız?

HiDream-I1-Full gibi büyük Yapay Zeka modellerini yerel olarak çalıştırmak önemli miktarda hesaplama kaynağı (güçlü GPU'lar, yeterli RAM ve depolama) ve teknik kurulum (bağımlılıkları yönetme, model ağırlıkları, ortam yapılandırmaları) gerektirir. Bir API kullanmak çeşitli avantajlar sunar:

HiDream-I1-Full'u API Aracılığıyla Nasıl Kullanılır

Birkaç platform Yapay Zeka modellerine ev sahipliği yapar ve API erişimi sağlar. HiDream-I1-Full için iki popüler seçeneğe odaklanacağız:

Seçenek 1: Replicate'in HiDream API'sini Kullanın

Replicate, altyapıyı yönetmeye gerek kalmadan, basit bir API aracılığıyla makine öğrenimi modellerini çalıştırmayı kolaylaştıran bir platformdur. Topluluk tarafından yayınlanan çok sayıda modelden oluşan geniş bir kitaplığa ev sahipliği yapıyorlar.

Replicate Nasıl Çalışır:

  1. Kimlik Doğrulama: Hesap ayarlarınızda bulabileceğiniz bir Replicate API belirteci gerekir. Bu belirteç Authorization başlığında iletilir.
  2. Bir Tahmin Başlatma: Tahminler için Replicate API uç noktasına bir POST isteği gönderirsiniz. İstek gövdesi, model sürümünü ve girdi parametrelerini (prompt, negative_prompt, seed vb. gibi) içerir.
  3. Eşzamansız İşlem: Replicate tipik olarak eşzamansız olarak çalışır. İlk POST isteği, bir tahmin kimliği ve durumu kontrol etmek için URL'lerle hemen döner.
  4. Sonuçları Alma: Durum succeeded (veya failed) olana kadar GET isteklerini kullanarak durum URL'sini (ilk yanıtta sağlanır) yoklamanız gerekir. Son başarılı yanıt, oluşturulan görüntü(ler)in URL'lerini içerecektir.

Kavramsal Python Örneği (requests kullanılarak):

import requests
import time
import os

REPLICATE_API_TOKEN = "YOUR_REPLICATE_API_TOKEN" # Üretimde ortam değişkenlerini kullanın
MODEL_VERSION = "TARGET_MODEL_VERSION_FROM_REPLICATE_PAGE" # örn., "9a0b4534..."

# 1. Tahmini Başlat
headers = {
    "Authorization": f"Token {REPLICATE_API_TOKEN}",
    "Content-Type": "application/json"
}
payload = {
    "version": MODEL_VERSION,
    "input": {
        "prompt": "Gün batımında görkemli bir siberpunk şehir manzarası, ıslak sokaklara yansıyan neon ışıklar, ayrıntılı illüstrasyon",
        "negative_prompt": "çirkin, deforme olmuş, bulanık, düşük kaliteli, metin, filigran",
        "width": 1024,
        "height": 1024,
        "seed": 12345
        # Replicate model sayfasına göre gerektiği gibi diğer parametreleri ekleyin
    }
}

start_response = requests.post("<https://api.replicate.com/v1/predictions>", json=payload, headers=headers)
start_response_json = start_response.json()

if start_response.status_code != 201:
    print(f"Tahmini başlatma hatası: {start_response_json.get('detail')}")
    exit()

prediction_id = start_response_json.get('id')
status_url = start_response_json.get('urls', {}).get('get')

print(f"Tahmin {prediction_id} kimliği ile başlatıldı")
print(f"Durum URL'si: {status_url}")

# 2. Sonuçları Yokla
output_image_url = None
while True:
    print("Durum kontrol ediliyor...")
    status_response = requests.get(status_url, headers=headers)
    status_response_json = status_response.json()

    status = status_response_json.get('status')
    if status == 'succeeded':
        output_image_url = status_response_json.get('output') # Genellikle URL'lerin bir listesi
        print("Tahmin başarılı!")
        print(f"Çıktı: {output_image_url}")
        break
    elif status == 'failed' or status == 'canceled':
        print(f"Tahmin başarısız oldu veya iptal edildi: {status_response_json.get('error')}")
        break
    elif status in ['starting', 'processing']:
        # Tekrar yoklamadan önce bekle
        time.sleep(5) # Yoklama aralığını gerektiği gibi ayarlayın
    else:
        print(f"Bilinmeyen durum: {status}")
        print(status_response_json)
        break

# Artık output_image_url'yi kullanabilirsiniz

Fiyatlandırma: Replicate, modelin donanımlarında yürütme süresine göre ücret alır. Ayrıntılar için fiyatlandırma sayfalarını kontrol edin.

Seçenek 2: Fal.ai

Fal.ai, API'ler aracılığıyla Yapay Zeka modelleri için hızlı, ölçeklenebilir ve uygun maliyetli çıkarım sağlamaya odaklanan başka bir platformdur. Genellikle gerçek zamanlı performansı vurgularlar.

Fal.ai Nasıl Çalışır:

  1. Kimlik Doğrulama: Fal API kimlik bilgilerine (Anahtar Kimliği ve Anahtar Sırrı, genellikle KeyID:KeySecret olarak birleştirilir) ihtiyacınız vardır. Bu, Authorization başlığında, tipik olarak Key YourKeyID:YourKeySecret olarak iletilir.
  2. API Uç Noktası: Fal.ai, belirli model işlevi için doğrudan bir uç nokta URL'si sağlar.
  3. İstek Biçimi: Modelin uç nokta URL'sine bir POST isteği gönderirsiniz. İstek gövdesi, modelin gerektirdiği girdi parametrelerini (Replicate'e benzer şekilde: prompt, vb.) içeren tipik olarak JSON'dur.
  4. Eşzamanlı ve Eşzamansız: Fal.ai her ikisini de sunabilir. Görüntü oluşturma gibi potansiyel olarak uzun süren görevler için şunları kullanabilirler:

Kavramsal Python Örneği (requests kullanılarak - eşzamansız kuyruk varsayılarak):

import requests
import time
import os

FAL_API_KEY = "YOUR_FAL_KEY_ID:YOUR_FAL_KEY_SECRET" # Ortam değişkenlerini kullanın
MODEL_ENDPOINT_URL = "<https://fal.run/fal-ai/hidream-i1-full>" # Fal.ai'deki tam URL'yi kontrol edin

# 1. İsteği Kuyruğa Gönder (Örnek - tam yapı için Fal belgelerini kontrol edin)
headers = {
    "Authorization": f"Key {FAL_API_KEY}",
    "Content-Type": "application/json"
}
payload = {
    # Parametreler genellikle Fal.ai sunucusuz işlevleri için doğrudan yükte bulunur
    # veya kurulumuna bağlı olarak bir 'input' nesnesinin içinde. Belgeleri kontrol edin!
    "prompt": "Uzayda süzülen bir astronotun hiperrealistik portresi, kask vizöründe yansıyan Dünya",
    "negative_prompt": "karikatür, çizim, illüstrasyon, eskiz, metin, harfler",
    "seed": 98765
    # Fal.ai uygulamasının desteklediği diğer parametreleri ekleyin
}

# Fal.ai, eşzamansız için '/queue' veya belirli sorgu parametrelerinin eklenmesini gerektirebilir
# Örnek: POST <https://fal.run/fal-ai/hidream-i1-full/queue>
# Belgelerini kontrol edin! Bir durum URL'si döndüren bir uç nokta varsayımı:

submit_response = requests.post(f"{MODEL_ENDPOINT_URL}", json=payload, headers=headers, params={"fal_webhook": "OPTIONAL_WEBHOOK_URL"}) # Web kancası gibi sorgu parametreleri için belgeleri kontrol edin

if submit_response.status_code >= 300:
    print(f"İstek gönderilirken hata: {submit_response.status_code}")
    print(submit_response.text)
    exit()

submit_response_json = submit_response.json()

# Fal.ai'nin eşzamansız yanıtı farklı olabilir - bir request_id veya doğrudan bir durum URL'si döndürebilir
# Bu kavramsal örnek için Replicate'e benzer bir durum URL'si döndürdüğünü varsayarsak
status_url = submit_response_json.get('status_url') # Veya request_id'den oluşturun, belgeleri kontrol edin
request_id = submit_response_json.get('request_id') # Alternatif tanımlayıcı

if not status_url and request_id:
     # Durum URL'sini oluşturmanız gerekebilir, örn., <https://fal.run/fal-ai/hidream-i1-full/requests/{request_id}/status>
     # Veya genel bir durum uç noktasını sorgulayın: <https://fal.run/requests/{request_id}/status>
     print("Durum URL'sini oluşturmanız veya request_id'yi kullanmanız gerekir, Fal.ai belgelerini kontrol edin.")
     exit() # Fal belgelerine göre özel uygulama gerekir

print(f"İstek gönderildi. Durum URL'si: {status_url}")

# 2. Sonuçları Yokla (eşzamansız ise)
output_data = None
while status_url: # Yalnızca bir durum URL'miz varsa yoklayın
    print("Durum kontrol ediliyor...")
    # Yoklama da kimlik doğrulaması gerektirebilir
    status_response = requests.get(status_url, headers=headers)
    status_response_json = status_response.json()

    status = status_response_json.get('status') # Durum anahtarları için Fal.ai belgelerini kontrol edin ('COMPLETED', 'FAILED', vb.)

    if status == 'COMPLETED': # Örnek durum
        output_data = status_response_json.get('response') # Veya 'result', 'output', belgeleri kontrol edin
        print("İstek tamamlandı!")
        print(f"Çıktı: {output_data}") # Çıktı yapısı Fal.ai'deki modele bağlıdır
        break
    elif status == 'FAILED': # Örnek durum
        print(f"İstek başarısız oldu: {status_response_json.get('error')}") # Hata alanını kontrol edin
        break
    elif status in ['IN_PROGRESS', 'IN_QUEUE']: # Örnek durumlar
        # Tekrar yoklamadan önce bekle
        time.sleep(3) # Yoklama aralığını ayarlayın
    else:
        print(f"Bilinmeyen durum: {status}")
        print(status_response_json)
        break

# output_data'yı kullanın (görüntü URL'lerini veya diğer bilgileri içerebilir)

Fiyatlandırma: Fal.ai tipik olarak yürütme süresine göre ücret alır, genellikle saniyede faturalandırma ile. Belirli model ve hesaplama kaynakları için fiyatlandırma ayrıntılarını kontrol edin.

Apidog ile HiDream API'sini Test Edin

Apidog, güçlü bir API tasarım, geliştirme ve test aracıdır. HTTP istekleri göndermek, yanıtları incelemek ve API ayrıntılarını yönetmek için kullanıcı dostu bir arayüz sağlar, bu da onları Replicate ve Fal.ai API'lerini kodda entegre etmeden önce test etmek için ideal hale getirir.

button

Apidog kullanarak HiDream-I1-Full API'sini Test Etme Adımları:

Adım 1. Apidog'u Yükleyin ve Açın: Apidog'u indirin ve yükleyin veya web sürümünü kullanın. Gerekirse bir hesap oluşturun.

Adım 2. Yeni Bir İstek Oluşturun:

Adım 3. HTTP Yöntemini ve URL'yi Ayarlayın:

Adım 4. Başlıkları Yapılandırın:

Content-Type başlığını ekleyin:

Authorization başlığını ekleyin:

Replicate için:

Fal.ai için:

Adım 5. İstek Gövdesini Yapılandırın:

Gövde sekmesine gidin.

raw biçimini seçin ve açılır menüden JSON'u seçin.

Platformun gereksinimlerine göre JSON yükünü yapıştırın.

Replicate için Örnek JSON Gövdesi:

{
  "version": "PASTE_MODEL_VERSION_FROM_REPLICATE_PAGE_HERE",
  "input": {
    "prompt": "Uyuyan bir kedi ile rahat bir kütüphane köşesinin sulu boya tablosu",
    "negative_prompt": "foto-gerçekçi, 3d render, kötü sanat, deforme olmuş",
    "width": 1024,
    "height": 1024,
    "seed": 55555
  }
}

Fal.ai için Örnek JSON Gövdesi

{
  "prompt": "Uyuyan bir kedi ile rahat bir kütüphane köşesinin sulu boya tablosu",
  "negative_prompt": "foto-gerçekçi, 3d render, kötü sanat, deforme olmuş",
  "width": 1024,
  "height": 1024,
  "seed": 55555
  // 'model_name' gibi diğer parametreler Fal.ai kurulumuna bağlı olarak gerekli olabilir
}

Önemli: Kullandığınız HiDream-I1-Full model sürümü için tam gerekli ve isteğe bağlı parametreler için Replicate veya Fal.ai sayfalarındaki belirli belgelere bakın. guidance_scale, num_inference_steps vb. gibi parametreler mevcut olabilir.

Adım 6. İsteği Gönderin:

Sonuçları Yokla (Eşzamansız API'ler için):

Görüntüyü Görüntüle: Son başarılı yanıttan görüntü URL'sini kopyalayın ve oluşturulan görüntüyü görüntülemek için web tarayıcınıza yapıştırın.

💡
Harika API Dokümantasyonu oluşturan harika bir API Test aracı mı istiyorsunuz?

Maksimum verimlilikle birlikte çalışmak için Geliştirici Ekibiniz için entegre, Hepsi Bir Arada bir platform mu istiyorsunuz?

Apidog tüm taleplerinizi karşılıyor ve Postman'in yerini çok daha uygun bir fiyata alıyor!
button

Sonuç

HiDream-I1-Full, güçlü görüntü oluşturma yetenekleri sunar ve Replicate veya Fal.ai gibi platformlardan API'ler kullanmak, bu teknolojiyi karmaşık altyapıyı yönetmeden erişilebilir hale getirir. API iş akışını (istek, potansiyel yoklama, yanıt) anlayarak ve test için Apidog gibi araçları kullanarak, en son teknolojiye sahip Yapay Zeka görüntü oluşturmayı projelerinize kolayca deneyebilir ve entegre edebilirsiniz.

Zamanla değişebileceğinden, en güncel uç nokta URL'leri, gerekli parametreler, kimlik doğrulama yöntemleri ve fiyatlandırma ayrıntıları için her zaman Replicate ve Fal.ai'deki belirli belgelere başvurun. İyi oluşturmalar!

Explore more

Fathom-R1-14B: Hindistan'dan Gelişmiş Yapay Zeka Muhakeme Modeli

Fathom-R1-14B: Hindistan'dan Gelişmiş Yapay Zeka Muhakeme Modeli

Yapay zeka hızla gelişiyor. FractalAIResearch/Fathom-R1-14B, 14.8 milyar parametreyle matematik ve genel akıl yürütmede başarılı.

5 June 2025

Mistral Code: İşletmeler için En Özelleştirilebilir Yapay Zeka Destekli Kodlama Asistanı

Mistral Code: İşletmeler için En Özelleştirilebilir Yapay Zeka Destekli Kodlama Asistanı

Mistral Code'u keşfedin: Kurumsal kullanıma özel, en özelleştirilebilir yapay zeka destekli kodlama asistanı.

5 June 2025

Claude Code'un 2025'te Yapay Zeka Kodlamasını Nasıl Dönüştürdüğü

Claude Code'un 2025'te Yapay Zeka Kodlamasını Nasıl Dönüştürdüğü

Claude Code, 2025'te yapay zeka destekli kodlamayı nasıl devrimleştiriyor? Özelliklerini, kullanımını ve Windsurf kısıtlamalarından sonra neden popüler olduğunu öğrenin. Geliştiriciler için okunması gereken!

5 June 2025

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin

Ücretsiz Kaydolİndir