API Documentation

Pengenalan

NASZ API membolehkan anda menjana imej & video AI secara programatik. Semua request guna HTTP biasa dengan respons JSON.

https://naszstudio.my.id

Authentication

Setiap request mesti sertakan API key dalam header Authorization:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx

Dapatkan key dari dashboard. Key ditunjuk sekali sahaja semasa dijana — simpan elok-elok.

Kredit & Kos

Kredit ditolak semasa request. Jika gagal, kredit dikembalikan automatik.

POST  Generate Imej

/v1/images/generations

Jana satu atau lebih imej dari prompt teks.

curl -X POST https://naszstudio.my.id/v1/images/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"desa di kaki gunung waktu golden hour","n":1,"aspect_ratio":"16:9"}'

{
  "created": 1775035361,
  "data": [ { "url": "https://cdn.../image-0.jpg" } ],
  "credits_charged": 3
}

import requests

API_KEY = "sk_live_xxx"
BASE = "https://naszstudio.my.id"
h = {"Authorization": f"Bearer {API_KEY}"}

r = requests.post(f"{BASE}/v1/images/generations", headers=h, json={
    "prompt": "kucing comel duduk atas sofa", "n": 1, "aspect_ratio": "1:1",
})
print(r.json()["data"][0]["url"])

POST  Generate Video

/v1/videos/generations

Jana video dari prompt. Bersifat async — pulang generation_id, kemudian poll untuk dapatkan hasil.

curl -X POST https://naszstudio.my.id/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"kucing berlari di padang","duration":5}'

{
  "generation_id": "a1b2c3...",
  "status": "queued",
  "credits_charged": 50,
  "poll_url": "/v1/videos/generations/a1b2c3..."
}

GET /v1/videos/generations/{id}

import requests, time
h={"Authorization":"Bearer sk_live_xxx"}
BASE="https://naszstudio.my.id"
r=requests.post(f"{BASE}/v1/videos/generations",headers=h,json={"prompt":"ombak laut","duration":5})
gid=r.json()["generation_id"]
while True:
    s=requests.get(f"{BASE}/v1/videos/generations/{gid}",headers=h).json()
    if s["status"]=="completed": print(s["asset_url"]); break
    if s["status"]=="failed": print(s["error_message"]); break
    time.sleep(8)

GET  Semak Baki Kredit

/v1/account/credits

curl https://naszstudio.my.id/v1/account/credits -H "Authorization: Bearer sk_live_xxx"

{ "email": "anda@email.com", "total_credits": 15 }

Model Tersedia

Aspect Ratio

Pengendalian Ralat

{ "error": { "code": "INSUFFICIENT_CREDITS", "message": "Kredit tidak mencukupi." } }

Had & Rate Limit

• Rate limit: 30 request / minit setiap API key
• Lebihan pulang 429 dengan header Retry-After
• Maksimum imej setiap request: 4
• Prompt maksimum: 5000 aksara