İcmal və sürətli başlanğıc

Sketchie prompt və ya sənədi ağ lövhə izahedici videoya çevirir və sizə həm render edilmiş videonu, həm də onun redaktə edilə bilən scene graph-ını qaytarır. Bu, HTTP API, CLI, TypeScript SDK və MCP serveri üçün istinaddır.

API girişi hər ödənişli plana daxildir. Planınız olduqda tətbiqdəki Parametrlərdən bir API açarı yaradın. API generasiyaları tətbiqlə eyni tariflə planınızın dəqiqələrindən istifadə edir. Ayrıca API qiyməti yoxdur.

Autentifikasiya

Hər sorğu API açarınızla Bearer tokeni kimi autentifikasiya olunur. Tətbiqdə Parametrlər altında bir açar yaradın, sonra onu Authorization başlığında göndərin:

Sorğu başlığı 
Authorization: Bearer sk_...

Açar yaradılışda bir dəfə göstərilir. Onu gizli saxlayın. Hər endpoint üçün əsas URL https://sketchie.ai/api-dır.

Sürətli başlanğıc

1. Bir izahat yaradın

Mövzunuzu input kimi və isteğe bağlı hədəf uzunluğu length kimi göndərin ("0:30" və ya "1:00" kimi rahat "M:SS" sətri, 30 saniyəlik addımlarla). Avtomatik uzunluq üçün length-i buraxın.

Terminal 
curl -X POST https://sketchie.ai/api/v1/explainer \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Explain how DNS resolves a domain name",
    "length": "0:30"
  }'

Çağırış növbədə olan qeydlə dərhal 202 Accepted qaytarır. Render arxa planda işləyir və bir neçə dəqiqə çəkir.

202 Accepted 
{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "queued",
  "prompt": "Explain how DNS resolves a domain name",
  "lengthSeconds": 30,
  "voice": "sketchie:sulafat",
  "language": "en",
  "aspect": "16:9",
  "videoUrl": null,
  "sceneGraph": null
}

2. Nəticə üçün poll edin

İzahatı status-u son vəziyyətə çatana qədər id ilə əldə edin. Həyat dövrü belədir: queued, sonra generating, sonra rendering, sonra ready (hazır) və ya failed.

Terminal 
curl https://sketchie.ai/api/v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b \
  -H "Authorization: Bearer sk_..."

O ready olduqda, qeyd video URL-ini və redaktə edilə bilən scene graph-ını daşıyır:

200 OK 
{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "ready",
  "videoUrl": "https://sketchie.ai/media/....mp4",
  "sceneGraph": { "scenes": [ ... ] }
}

Rahat və klassik sahə adları. input və length rahat sorğu sahələridir. Köhnə prompt (sətir) və lengthSeconds (rəqəm, 30-un müsbət qatı) hələ də ləqəb kimi qəbul edilir, ona görə mövcud inteqrasiyalar işləməyə davam edir. Hər ikisi göndərildikdə, rahat sahə qalib gəlir.

Sonra hara getmək

  • API istinadı . Hər endpoint, sorğu və cavab formaları ilə.
  • Səslər . Standart danışan, altı səslik kataloq və oynadıla bilən önizləmələr.
  • Dillər . Dəstəklənən 34 nağıl dili.
  • CLI və SDK . sketchie əmr sətri və @sketchie/sdk TypeScript müştərisi.
  • MCP quraşdırması . Sketchie-ni Claude Desktop, Claude Code və Claude tətbiqində alət kimi istifadə edin.