Fellowis API gör nu video: nycklar, modeller, första anropet

Tills nyligen gjorde Fellowis API en sak: text in, bild ut. Nu gör det betydligt mer. Samma nyckel skapar videoklipp, du väljer modell för både bilder och video, och API Console listar varenda en med pris, så ingen behöver gissa. Behöver din produkt bilder eller korta rörelser och vill du inte köra egna GPU:er för det är den här texten skriven för dig.

Vad som ändrats, kort

• Video med samma nyckel. Image-to-video, text-to-video och klipp styrda av referensbilder, med samma saldo och samma form på anropet som bilder.
• Ett fält model. En snabbare, billigare modell för utkast och en starkare för slutversionen. För bilder kan du utelämna det och få exakt det en äldre integration alltid fått, till samma pris; ett videoanrop anger alltid sin modell.
• En katalog som koden kan läsa. GET /v1/api/models svarar med vad din nyckel får anropa och vad det kostar, så att din app kan bygga ett eget modellval i stället för att skeppa en lista som blir inaktuell.
• En genväg för själva integrationen. Konsolen har en knapp ”Copy for ChatGPT/Claude” som kopierar hela referensen på en gång. Klistra in den i din kodassistent och be om en klient i ditt språk.

Skaffa en nyckel

Skapa ett gratiskonto, öppna /api-console, namnge en nyckel och skapa den. Hela nyckeln visas exakt en gång; sedan sparar konsolen bara en förhandsvisning, så kopiera den direkt till ditt hemlighetsvalv. Varje anrop skickar den som bearer-header:

Authorization: Bearer fk_live_your_key_here

Använd en nyckel per miljö eller per produkt. Varje nyckel kan ha ett eget dagligt myntbudget, det enklaste sättet att se till att en bugg i en testloop inte gör slut på hela saldot under natten.

Din första bild

En generering är asynkron. Du köar den, får tillbaka 202 direkt, och bilden kommer lite senare:

POST /v1/api/images
Content-Type: application/json
Authorization: Bearer fk_live_your_key_here
Idempotency-Key: 7f1c2b90-order-4411

{
  "prompt": "a ceramic mug on a linen cloth, soft window light",
  "quality": "standard",
  "aspectRatio": "4:5"
}

Headern Idempotency-Key är viktigare än den ser ut. Nätverk tappar svar; med headern ger ett nytt försök av samma anrop samma generering i stället för att betala två gånger. Skapa en per försök, till exempel från ditt eget order-id. Fråga sedan tills den är klar och ladda ner resultatet:

GET /v1/api/images/{id}          -> "queued" ... "succeeded"
GET /v1/api/images/{id}/content  -> the image bytes

quality, format, aspectRatio och en betald promptförbättring är alla valfria, och varje standardvärde är vad API:t gjorde innan alternativet fanns. Lägg in några URL:er till referensbilder i images så körs anropet på redigeringsmodellen - så håller du en karaktär eller en produkt igenkännbar mellan bilder.

Välja modell

GET /v1/api/models

Det här returnerar de bild- och videomodeller din nyckel får använda, med myntpriser och för video det längsta klippet, tillgängliga upplösningar och om en startbild krävs. Skicka den du vill ha som model. Ett vettigt mönster är en billig modell medan användaren provar och den starkare för versionen hen behåller. Aktuella siffror finns också på produktsidan, som läser dem ur samma kod som drar dina mynt.

Ditt första klipp

Image-to-video börjar med en stillbild. Ladda upp den en gång och spara id:t:

POST /v1/api/uploads
{ "imageBase64": "<your start frame, base64>" }

-> { "upload": { "id": "..." } }

Köa sedan klippet, precis som en bild:

POST /v1/api/videos
Idempotency-Key: 7f1c2b90-clip-4411

{
  "model": "fellowi-image-to-video-turbo",
  "uploadId": "<id from /v1/api/uploads>",
  "prompt": "steam rises slowly from the mug, the camera drifts in",
  "durationSec": 5,
  "resolution": "720p",
  "generateAudio": false
}

Fråga GET /v1/api/videos/{id} tills statusen är succeeded och ladda ner videoUrl. Ett klipp tar minuter, inte sekunder, så fråga lugnt och berätta det för dina användare. Text-to-video-modeller behöver ingen uppladdning alls. Priset gäller per sekund klipp i vald upplösning, och ljud och extra referensbilder läggs till där en modell stöder dem. Klipp via API:t betalas alltid med mynt; en Director-plans kvot gäller bara klipp gjorda i webbens videostudio.

Koppla in det i en riktig produkt

• Håll nyckeln på din server. Skicka den aldrig till en webbläsare eller mobilapp. Din backend anropar oss, din frontend anropar din backend.
• Behandla det som en jobbkö. Spara genererings-id:t med din egen post, fråga från en worker och spara en egen kopia av filen när den kommer. Vår kopia är till för leverans, inte som ditt arkiv.
• Misslyckande är ett normalt utfall. En misslyckad generering betalar själv tillbaka sina mynt och rapporterar en av fyra koder: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR eller UNKNOWN. Visa något användbart för var och en och låt användaren försöka igen.
• Respektera gränsen för anrop per nyckel. Den skyddar mot missbruk, är ingen kvot, och syns bredvid varje nyckel i konsolen. Det verkliga taket är ditt myntsaldo.

Prissättning och återbetalningar går vi igenom närmare i varför API:t tar betalt i mynt, och vuxet innehåll i samma API i vår guide till API:t för karaktärsgenerering.

Vad det inte gör

Webhooks finns inte än: du frågar. Någon gratisnivå finns inte: varje anrop kostar mynt, till samma pris som i studion. Det renderar inte det som modereringen avvisar, och vuxet innehåll hör inte hemma på offentliga plattformar oavsett vad din app är. Och även om våra villkor inte begränsar kommersiell användning av det du genererar lovar vi inte att en bild är unik eller fri från alla tredje parts rättigheter - behandla den som en stockbild du inte själv fotograferat. Passar det det du bygger börjar du i konsolen.