api.horny.studio

API referansı

Queue, dosyalar, webhook ve hata codes. Calls go → https://api.horny.studio/v1. catalog ve prices dır aç üzerinde API page.

Catalog ve Fiyatsapi.horny.studio/v1

Quick başlat

İlk istek

Temel URL: https://api.horny.studio/v1

curl

curl -X POST https://api.horny.studio/v1/queue/bytedance/seedance-2.5/text-to-video \
  -H "Authorization: Key ch_live_…" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a quiet street at dusk, handheld","duration_seconds":8,"resolution":"1080p","generate_audio":true}'

202 response contains request_id, status_url, response_url ve İptal_url.
Poll status_url every 2–5 saniye veya pass webhook_url.
Üzerinde COMPLETED fetch result kaynak response_url. Dosya links dır valid için 24 hours.

Için AI agents

Makine okunur kaynaklar

Referans

Yöntemler

GET	`/models`	Model catalog, units ve Fiyats
POST	`/estimate`	Başlatmadan önce kesin istek maliyeti
POST	`/chat/completions`	Text Model: Mesajs ve max_tokens, bir direct reply veya bir stream
POST	`/queue/{model_id}`	Queue bir üretim, 202 response ile request_id
GET	`/requests/{id}/status`	Durum: IN_QUEUE, IN_PROGRESS, COMPLETED, Başarısız
GET	`/requests/{id}/response`	Result ile signed Dosya links
PUT	`/requests/{id}/cancel`	İptal bir queued request
POST	`/files`	Input file, returns file_id yükleyin
GET	`/requests/{id}`	İstek kartı: durum, teklif, gerçek ücret

Webhook'lar

Tamamlanma bildirimi

Pass webhook_url giriş query veya body. Treat notification as bir signal → fetch result: onayla it via response_url ile your key.

http

POST https://api.horny.studio/v1/queue/bytedance/seedance-2.5/text-to-video?webhook_url=https://example.com/hooks/imhorny

// после завершения на webhook_url придёт POST
{
  "request_id": "req_9f2c…",
  "status": "COMPLETED",
  "response_url": "https://api.horny.studio/v1/requests/req_9f2c…/response"
}

Dosyalar

Input Dosyalar

POST /v1/Dosyalar ile bytes ve bir Content-Type. response holds bir Dosya_id like chDosya_…, which goes into any URL field input.

Public https links → input dosyalar dır accepted as well
Results dır değil archived: bir signed link lives 24 hours, then 410
An Idempotency-Key header protects tekrarst duplicate submits

Hatalar

Yanıt kodları

401	`unauthorized`	Key missing, revoked veya invalid
402	`insufficient_balance`	shared USDT bakiye cannot cover hold. Top up giriş studio hesap. There no separate wallet
402	`key_limit_reached`	key's monthly limit reached
400	`unknown_model · unpriceable`	Model değil giriş catalog veya inputs do değil allow pricing
409	`idempotency_conflict`	Same Idempotency-Key ile bir different body
409	`request_not_ready`	Tamamlanmadan önce sonuç istendi
429	`rate_limited`	Key RPM veya concurrency limit exceeded
503	`capacity_unavailable`	Capacity geçici olarak kullanılamıyor — retry later, nothing idi charged
410	`expired`	signed link (24 saat) has expired