Getting Started
# Generate text
blink ai text "Write a poem about coding"
# Generate image
blink ai image "A sunset over mountains" --model fal-ai/nano-banana-pro
# Generate video
blink ai video "A cooking tutorial scene" --aspect-ratio 9:16
# Text-to-speech
blink ai speech "Hello world" --voice nova
# Transcribe audio
blink ai transcribe ./recording.mp3
# AI phone call
blink ai call +15551234567 --prompt "Remind about appointment tomorrow at 3pm"
MCP Tools
| Tool |
Description |
blink_ai_text |
Generate text from prompt or messages |
blink_ai_image |
Generate or edit images |
blink_ai_image_edit |
Edit an existing image using a text prompt |
blink_ai_video |
Generate video from text or image |
blink_ai_animate |
Animate a still image into a video |
blink_ai_speech |
Convert text to audio |
blink_ai_transcribe |
Convert audio to text |
blink_ai_call |
Make AI-powered phone call |
blink_ai_call_status |
Check the status of an AI phone call |
SDK Methods
const { text } = await blink.ai.generateText({ prompt: 'Hello', search: true })
const { data } = await blink.ai.generateImage({ prompt: 'A robot', model: 'fal-ai/nano-banana-pro' })
const { result } = await blink.ai.generateVideo({ prompt: 'Ocean waves', model: 'fal-ai/veo3.1/fast' })
const { url } = await blink.ai.generateSpeech({ text: 'Hello', voice: 'nova' })
const { text } = await blink.ai.transcribeAudio({ audio: audioData, language: 'en' })
Text Generation
# Simple prompt
blink ai text "Summarize quantum computing"
# With web search for real-time info
blink ai text "Latest AI news today" --search
# Stream output
blink ai text "Write a story" --stream
await blink.ai.streamText(
{ prompt: 'Write a story...', search: true },
(chunk) => setText(prev => prev + chunk)
)
Image Models
| Model |
Speed |
Quality |
Best For |
fal-ai/nano-banana (default) |
Fast |
Good |
Prototypes |
fal-ai/nano-banana-pro |
Standard |
Excellent |
Marketing, high-fidelity |
fal-ai/nano-banana/edit |
Fast |
Good |
Quick adjustments, style transfer |
fal-ai/nano-banana-pro/edit |
Standard |
Excellent |
Detailed retouching |
Video Models
| Model |
Type |
Best For |
fal-ai/veo3.1/fast (default) |
T2V |
Fast, good quality |
fal-ai/veo3.1 |
T2V |
Best quality |
fal-ai/sora-2/text-to-video/pro |
T2V |
Cinematic |
fal-ai/veo3.1/image-to-video |
I2V |
Animate images |
Speech Voices
alloy (default), echo, fable, nova, onyx, shimmer
Transcription Models
| Model |
Notes |
fal-ai/whisper (default) |
Best accuracy |
fal-ai/wizper |
Faster, Whisper v3 optimized |
fal-ai/speech-to-text/turbo |
Fast, lower cost |
Critical Rules
- Image URLs must be HTTPS with extension —
.jpg, .png, .gif, .webp
- Style transfer — provide ALL images in array, reference by position in prompt
- I2V requires image upload — upload to storage first, use public URL
- generateObject schema must be
type: "object" — wrap arrays inside object
- System prompts must be domain-specific — never use "You are a helpful assistant"
AI Phone Calls
# Outbound call with custom prompt
blink ai call +15551234567 --prompt "You are a scheduling assistant. Confirm the appointment."
# With voice selection
blink ai call +15551234567 --prompt "Remind about meeting" --voice nova
Requires a phone number — see blink-notifications skill for blink phone buy.
blink-new