daVinci-MagiHuman API

sand-ai/davinci-magihuman/image-to-video

Obraz na wideo daVinci-MagiHuman ożywia twoje zdjęcie w klip 5-10 sekund, nadając mu ruch i głos: zapisz kwestię w cudzysłowie w prompcie albo dołącz własne audio. 256p, 720p albo 1080p, 16:9 lub 9:16.

Od $0.024/s

Uruchom model Zobacz API

Wyślij żądanie

Przykłady korzystają z publicznych definicji parametrów wybranego endpointu. Podmień klucz API i przykładowe media, a potem wyślij żądanie ze swojego serwera.

SDK i integracje

POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Uwierzytelnianie API

Klucz API trzymaj w zmiennej środowiskowej serwera SPICY_API_KEY. Dla żądań JSON używaj uwierzytelniania Bearer i Content-Type: application/json.

Authorization: Bearer $SPICY_API_KEY

Przykładowy wynik

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "sand-ai/davinci-magihuman/image-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "image_url": "https://example.com/reference.png",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Wygenerowane ze schematu wejścia tego modelu – tego samego, względem którego API waliduje każde żądanie.

Parametry wejściowe

Te pola umieść w obiekcie input w ciele żądania. Nazwy i typy odpowiadają API. Gdy wartości domyślnej nie podano, nie zakładaj żadnej.

image_urlstringWymagane

Pierwsza klatka. Publiczny link, z którego da się pobrać plik bezpośrednio; klip zaczyna się od tego zdjęcia.

Domyślnie: Nie określono
Ograniczenia: format:"uri"
contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]

promptstringWymagane

Wymagany. Opisz, co dzieje się po zdjęciu: co robi osoba i, w cudzysłowie, co mówi. Gdy ustawiasz audio_url, pomiń słowa i opisz nastrój, ruch i światło.

Domyślnie: Nie określono
Ograniczenia: minLength:3
maxLength:5000

seedintegerOpcjonalne

Opcjonalna liczba całkowita. Ten sam seed przy tych samych danych wejściowych daje wyniki podobne, a nie gwarantowane identyczne.

Domyślnie: Nie określono
Ograniczenia: minimum:0
maximum:2147483647

duration_secondsintegerOpcjonalneWpływa na cenę

5-10 sekund, domyślnie 5, rozliczane za sekundę.

Domyślnie: 5
Ograniczenia: minimum:5
maximum:10

resolutionstringOpcjonalneWpływa na cenę

256p, 720p (domyślnie) albo 1080p. Wyższe poziomy kosztują więcej za sekundę. Model renderuje w małej rozdzielczości, a jego własny etap super-rozdzielczości tworzy wyższe poziomy; nasze przebiegi w 720p wyszły około 1358 x 678.

Domyślnie: "720p"
Dozwolone wartości: "256p""720p""1080p"

aspect_ratiostringOpcjonalne

16:9 (domyślnie) albo 9:16. Nasze przebiegi obraz na wideo używały 16:9. Kształt nie zmienia ceny.

Domyślnie: "16:9"
Dozwolone wartości: "16:9""9:16"

audio_urlstringOpcjonalne

Opcjonalnie. Publiczny link do pliku z mową albo piosenką; wideo powstaje w synchronizacji z nim zamiast wymyślania głosu. W naszym przebiegu użyliśmy 5-sekundowego nagrania do 5-sekundowego klipu.

Domyślnie: Nie określono
Ograniczenia: format:"uri"
contentMediaType:["audio/mpeg","audio/wav"]

{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "16:9",
      "description": "Output aspect ratio.",
      "enum": [
        "16:9",
        "9:16"
      ],
      "type": "string",
      "x-ui": {
        "order": 80,
        "widget": "radio"
      }
    },
    "audio_url": {
      "contentMediaType": [
        "audio/mpeg",
        "audio/wav"
      ],
      "description": "Optional speech or song (MP3 or WAV). When given, the clip is generated in sync with it instead of a voice the model writes.",
      "format": "uri",
      "type": "string",
      "x-ui": {
        "accept": [
          "audio/mpeg",
          "audio/wav"
        ],
        "order": 88,
        "widget": "upload"
      }
    },
    "duration_seconds": {
      "default": 5,
      "description": "Clip length in whole seconds, 5 to 10. Billed per second.",
      "maximum": 10,
      "minimum": 5,
      "type": "integer",
      "x-ui": {
        "affects_price": true,
        "order": 60,
        "step": 1,
        "unit": "s",
        "widget": "slider"
      }
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "The first frame: the clip starts from this image.",
      "format": "uri",
      "type": "string",
      "x-ui": {
        "accept": [
          "image/jpeg",
          "image/png",
          "image/webp"
        ],
        "order": 95,
        "widget": "upload"
      }
    },
    "prompt": {
      "description": "What happens, and in quotes what the person says. The model speaks quoted lines itself.",
      "maxLength": 5000,
      "minLength": 3,
      "type": "string",
      "x-ui": {
        "order": 100,
        "primary": true,
        "widget": "textarea"
      }
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution. The model generates at a low base size and upscales with its own super-resolution stage; higher tiers cost more per second.",
      "enum": [
        "256p",
        "720p",
        "1080p"
      ],
      "type": "string",
      "x-ui": {
        "affects_price": true,
        "order": 70,
        "widget": "radio"
      }
    },
    "seed": {
      "description": "Random seed for controlled comparisons.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer",
      "x-ui": {
        "order": 10,
        "widget": "number"
      }
    }
  },
  "required": [
    "image_url",
    "prompt"
  ],
  "type": "object",
  "x-pricing": {
    "billingMode": "variant_matrix",
    "variantFields": [
      "resolution"
    ]
  }
}

Śledź zadanie

HTTP 202 oznacza, że zadanie zostało przyjęte, a nie ukończone. Zapisz zwrócone taskId i odpytuj właśnie to zadanie. Nie twórz kolejnego zadania, czekając na jego wynik.

Odpowiedź o przyjęciu

HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

Odpowiedź o przyjęciu zawiera szacunek, dzięki czemu twoja aplikacja pokaże tę samą kwotę w historii zadań i w rozliczeniach.

Odczytaj zadanie

curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Zacznij odpytywać mniej więcej co 2 sekundy i stopniowo wydłużaj odstęp. Zatrzymaj się na stanie końcowym. Po zerwaniu połączenia odpytaj pierwotne taskId. Tworzenie ponawiaj wyłącznie z pierwotnym kluczem idempotentności i pierwotnym ciałem żądania.

Albo odbierz wynik przez callback

import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Podaj callBackUrl przy tworzeniu zadania, a gotowy rekord przyjdzie do ciebie metodą POST – bez żadnej pętli odpytywania. Każda dostawa niesie X-Webhook-Timestamp, X-Webhook-Signature i X-Webhook-Payload-Version. Podpis to HMAC-SHA256 w base64 z taskId.timestamp.sha256(body), więc trzeba go sprawdzać na surowych bajtach: sparsowanie JSON-a i ponowne zserializowanie zmienia je i weryfikacja się nie powiedzie. Nieudane dostawy są ponawiane, więc to samo taskId może przyjść dwa razy – zrób obsługę idempotentną. Najpierw odpowiedz kodem 2xx, a pracę wykonaj potem; wolna obsługa jest traktowana jak nieudana dostawa.

Odczytaj wynik

Wynik wykorzystuj dopiero przy stanie succeeded. Przy niepowodzeniu skorzystaj z errorCode, errorMessage i request_id. Przykładowe koszty i stany nie odpowiadają rzeczywistemu rozliczeniu.

Przykład odpowiedzi po zakończeniu

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "sand-ai/davinci-magihuman/image-to-video",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Każdy dostępny materiał otwieraj lub pobieraj bezpośrednio spod assets[].url, bez nagłówka Authorization. Podpisany adres wygasa o expiresAt; odpytaj zadanie ponownie, żeby go odświeżyć, dopóki materiał mieści się w okresie przechowywania. Materiał oczekujący lub niedostępny nie ma adresu. Podpisane adresy traktuj jako prywatne.

SDK i integracje

Korzystaj ze SpicyAPI w aplikacji, terminalu, asystencie AI lub wizualnym przepływie pracy. Wybierz instrukcję konfiguracji.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Polecenia terminala i skrypty automatyzacji.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrukcje wielokrotnego użytku dla asystenta AI.

n8n

Węzły społecznościowe dla instalacji self-hosted i szablony HTTP Request do importu w n8n Cloud.

ComfyUI

Przepływy obrazów, wideo i dźwięku na płótnie węzłów.

Więcej integracji

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Przeglądaj gotowe przepływy pracy

Nie musisz pisać żadnego z powyższych fragmentów kodu. Wystarczy raz podłączyć serwer MCP, a każdy agent obsługujący MCP — Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat — może uruchomić ten model po nazwie. Można go też wywołać z powłoki jednym poleceniem.

Powiedz to swojemu agentowi

Użyj sand-ai/davinci-magihuman/image-to-video, żeby ożywić ./poster.png – powolny najazd, pięć sekund – i zapisz klip obok pliku źródłowego.

Agent znajduje model w aktualnym katalogu, sam wysyła plik lokalny, a potem pokazuje dokładną wycenę wraz z maksymalną opłatą i czeka na twoje potwierdzenie. Nic nie zostaje naliczone, dopóki nie zgodzisz się wprost.

Podłącz raz

claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
  -- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skill

Pierwsza linia daje agentowi narzędzia; druga daje mu Skill, czyli reguły ich używania: najpierw wycena, potem opłata, wysyłanie plików lokalnych zamiast wklejania bajtów i odczyt gotowego adresu materiału zamiast zgadywania. Każdy inny klient podłącza ten sam serwer przez własny plik konfiguracyjny – zobacz centrum dla deweloperów.

Albo jedno polecenie w powłoce

npx @spicyapi/cli tasks create --model sand-ai/davinci-magihuman/image-to-video \
  --input-json '{"aspect_ratio":"16:9","duration_seconds":5,"image_url":"https://example.com/reference.png","prompt":"A slow aerial shot drifting over a misty pine forest at sunrise","resolution":"720p"}' \
  --wait

Wejściem jest własny schemat tego endpointu, ten sam co w przykładach powyżej. --wait odpytuje aż do zakończenia zadania i wypisuje wynik; dodaj --yes, żeby pominąć pytanie o potwierdzenie w CI. Najpierw ustaw SPICY_API_KEY – jeden klucz działa w API, w CLI i na serwerze MCP.

Pliki lokalne

npx @spicyapi/cli files upload ./poster.png
# -> spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3

npx @spicyapi/cli tasks create --model sand-ai/davinci-magihuman/image-to-video \
  --input-json '{"image_url":"spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3"}' \
  --wait

Ciało żądania przyjmuje adresy, a nie bajty. Najpierw wyślij plik i podaj wypisany identyfikator spicy:// – nazwa pola powyżej pochodzi wprost ze schematu tego endpointu. Agent na MCP robi ten krok za ciebie, dlatego zdanie wyżej może wskazać ./poster.png bezpośrednio. Media dostępne już publicznie po HTTPS nie wymagają wysyłania.

Jak długo przechowujemy wyniki

npx @spicyapi/cli tasks create --model sand-ai/davinci-magihuman/image-to-video \
  --input-json '{…}' --retention 1h --wait

npx @spicyapi/cli tasks get $TASK_ID   # read back the retention that applied

--retention potrafi wyłącznie skrócić okno – 30m, 1h, 7d albo 0, żeby usunąć zaraz po osiągnięciu przez zadanie stanu końcowego. Obowiązuje najkrótsza z trzech wartości: twojego żądania, ustawień konta i maksimum platformy, więc odczytaj ją z rekordu zadania, zamiast zakładać, że podana liczba zadziałała. Podanie okna dłuższego, niż pozwala konto, nic nie zmienia.

Użyj w ComfyUI

Zainstaluj węzły SpicyAPI przez ComfyUI Manager albo poleceniem poniżej, a potem wyszukaj na płótnie daVinci-MagiHuman · Image to Video. Węzeł ma te same opcje co ta strona i pokazuje cenę, zanim ruszy.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Przykładowe workflowy Poradnik konfiguracji Kod źródłowy na GitHubie

Osadzony panel czyta ten sam schemat co ta strona, więc nie może się od API rozjechać. Jeśli twoja dokumentacja potrzebuje treści przeszukiwalnej, pobierz JSON spod /api/embed/models/ i wyrenderuj go samodzielnie.

<iframe src="https://spicyapi.ai/embed/pl/models/davinci-magihuman/api?model=sand-ai%2Fdavinci-magihuman%2Fimage-to-video" width="100%" height="560" loading="lazy" title="Przykładowe żądanie" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Otwórz panel

Obszar roboczy

Wyślij żądanie

Uwierzytelnianie API

Parametry wejściowe

Śledź zadanie

Odczytaj wynik

SDK i integracje

Użyj w ComfyUI