API belgeleri

Yayınlanan her iş akışının bir uç noktası vardır. Girdiler “Girdi” düğümlerinin, çıktılar “Çıktı” düğümlerinin anahtarlarıdır.

Temel adres: https://api.mlgrid.com

Kimlik doğrulama

“API anahtarları” sayfasından bir anahtar oluşturun ve Authorization başlığında gönderin.

headerhttp
Authorization: Bearer mlg_xxxxxxxxxxxxxxxx

İş akışını çalıştır

İstek eşzamanlıdır ve çalıştırma bitince sonucu döndürür.

requesthttp
POST https://api.mlgrid.com/v1/workflows/{slug}/run
Content-Type: application/json

{ "input": { "text": "..." } }
200 OKjson
{
  "id": "cm...",
  "status": "succeeded",
  "output": { "summary": "..." },
  "usage": { "tokensIn": 812, "tokensOut": 164, "cost": "38.2", "currency": "IRT" }
}

Çıktı dosyaları

Görsel, ses, video, PDF, Word ve Excel gibi çıktılar URL olarak döner. Bu dosyalar oluşturulduktan 24 saat sonra silinir; gerekiyorsa hemen indirip saklayın.

Girdi/çıktı sözleşmesini al

requesthttp
GET https://api.mlgrid.com/v1/workflows/{slug}

Çalıştırma durumu

requesthttp
GET https://api.mlgrid.com/v1/runs/{id}

Bellek ve oturumlar

İş akışında “Belleği oku” ve “Belleğe kaydet” düğümleri varsa, aynı session aynı konuşmanın devamı sayılır. Bellek her kullanıcı (API anahtarı) için ayrıdır; herkese açık bir iş akışının farklı kullanıcıları birbirinin belleğini asla görmez. Ayarlanan pencereden eski mesajlar özetleme için bağladığınız düğüme verilir ve özet onların yerini alır.

requesthttp
POST https://api.mlgrid.com/v1/workflows/{slug}/run
Authorization: Bearer mlg_xxxxxxxx
Content-Type: application/json

{ "input": { "message": "اسم من سارا است" }, "session": "user-42" }
Belleği temizlehttp
DELETE https://api.mlgrid.com/v1/workflows/{slug}/memory?session=user-42

Maliyet hesaplama

Düğüm maliyeti = (girdi token × girdi fiyatı + çıktı token × çıktı fiyatı) ÷ 1.000.000 + çağrı başına sabit ücret. Toplam maliyet tüm düğümlerin toplamı artı (varsa) oluşturucu komisyonudur ve arayanın cüzdanından düşülür.

Token’lar doğrudan model sağlayıcısının raporundan okunur. Çalıştırma yarıda başarısız olursa yalnızca çalışan düğümler ücretlendirilir.

Hatalar

400Geçersiz istek gövdesi (ör. input alanı gönderilmemiş).
401API anahtarı gönderilmedi veya iptal edildi.
402Cüzdan bakiyesi yetersiz.
404İş akışı yok, yayınlanmamış ya da özel.
422Düğümlerden biri başarısız oldu; yanıttaki nodeId hangisi olduğunu gösterir.
429Çok fazla istek (kullanıcı başına dakikada 60).

Özel model oluştur

main.py bir execute fonksiyonu tanımlamalı. Dönüş değeri ya doğrudan çıktı sözlüğüdür ya da token bildirimi için outputs ve usage içerir.

main.pypython
def execute(inputs, params):
    text = inputs.get("text", "")
    return {
        "outputs": {"text": text[::-1]},
        "usage": {"tokensIn": len(text), "tokensOut": len(text)},
    }