Early access is open. Free for our first 100 users.
Sign in

HEYBLINKI FOR DEVELOPERS

Build with
our models.

Bring Blinki into your application.
Our own models. A straightforward API. Your next idea.

Open console Read the docs
Research API · Start with Blinki Motion

FROM FIRST CALL TO FIRST CLIP

A small beginning.
Built to become yours.

Discover our model family, create a private key, and try the implemented Blinki Motion prototype where research inference is connected. No third-party model fallback.

Meet our models 
curl --fail-with-body https://www.heyblinki.com/api/v1/models \
  -H "Authorization: Bearer $HEYBLINKI_API_KEY"

Your keys. Your apps.

Create account-scoped credentials, copy them once, and revoke access from your console.

A real playground.

Send model discovery and research video requests. Inspect the response and copy the request into your app.

See every request.

Review your recent request status, response time and actual usage. No invented metrics.

API REFERENCE · v1

Make your first request.

Use the API from your application’s server. API keys authenticate requests independently of browser sessions.

1. Create a key

Sign in to the console’s API keys page. Create a named key and copy the secret. Keys expire after 90 days; revocation takes effect on subsequent requests. The full secret is never shown again.

2. Authenticate

Set HEYBLINKI_API_KEY in your server environment. Send Authorization: Bearer $HEYBLINKI_API_KEY on each request. Never put the secret in a URL, browser bundle or public repository.

Base URL: https://www.heyblinki.com/api/v1. The console’s examples use the deployment you are viewing.

GET/api/v1/models

Returns { "object": "list", "data": [...] } with owned model IDs, versions, status and deployment-specific available flags. Future slots are marked unavailable. An active key is required.

POST/api/v1/videos

Run the existing Blinki Motion research checkpoint. Returns an MP4 directly with Content-Type: video/mp4. Save the response bytes to a file. This synchronous research endpoint can take up to 90 seconds.

FieldTypeDescription
modelstringblinki-motion-0.0
promptstringRequired, 1–500 characters. Try “a blue square moving right”.
seedintegerOptional, 0–2,147,483,647. Default: 42.

The fixed output is 32 × 32 pixels, 8 frames at 8 fps: 1 second, without audio. This procedural-motion prototype is not a cinematic model. Other resolutions, durations and third-party models are not accepted.

curl --fail-with-body https://www.heyblinki.com/api/v1/videos \
  -H "Authorization: Bearer $HEYBLINKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"blinki-motion-0.0","prompt":"a blue square moving right","seed":42}' \
  --output motion.mp4

Availability and limits

The catalog reports the runtime available on the current deployment. A host without the owned checkpoint returns 503 model_unavailable; it never switches to another model. The general Chat and Compose generators remain disabled.

Limits are shared across your account: 60 requests per minute, including up to 5 generation attempts. The research runner handles one clip at a time per host. Request bodies are limited to 8 KB.

Errors and request history

Errors use { "error": { "code": "…", "message": "…" } }. Every response includes X-Request-Id. Usage history keeps metadata for 30 days, without prompts, raw keys or generated media.

StatusMeaning
400 / 413 / 415Invalid JSON, fields, size or content type.
401Missing, expired or revoked API key.
404Unknown model ID.
408Generation timed out or was cancelled.
429Account limit reached or research runner busy. Retry-After is included.
503Owned model or developer service unavailable.

Start with a single call.

Open developer console