Media Generation

Generate images, videos, and remove captions/watermarks from videos. All media endpoints use studio credits and follow the same async job pattern — submit a request, receive a job_id, then poll /api/job-status/:job_id for results. Image and video generation are available on all plans; caption removal requires a Professional or Ultimate plan.

POST /api/caption-remover

Remove captions and watermarks from a video. Accepts a publicly accessible video URL or a TikTok/Instagram Reel link — the API downloads and processes the video via AI, then returns a cleaned video uploaded to CDN. Credits are deducted upfront and refunded automatically if processing fails.

Request Body (JSON)

Name	Type	Required	Description
video_url	string	Required	Direct video URL, TikTok link (`https://www.tiktok.com/@user/video/{id}`), or Instagram Reel link (`https://www.instagram.com/reels/{id}/`)

Cost: 12 studio credits per minute of video (0.2 credits per second, rounded up). Max duration: 90 seconds. Processing can take up to 30 minutes depending on video length.

Example Request (Direct URL)

curl -X POST "https://api.algrow.online/api/caption-remover" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"video_url": "https://example.com/my-video.mp4"}'

Example Request (TikTok)

curl -X POST "https://api.algrow.online/api/caption-remover" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"video_url": "https://www.tiktok.com/@username/video/1234567890123456789"}'

Example Request (Instagram Reel)

curl -X POST "https://api.algrow.online/api/caption-remover" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"video_url": "https://www.instagram.com/reels/DWPuSZWATDC/"}'

Response 200 200

{
                  "success": true,
                  "job_id": "a5358a1c-388d-47a3-989e-755291031d77",
                  "status": "pending",
                  "duration_seconds": 28.5,
                  "credit_cost": 6,
                  "message": "Caption removal queued. Poll /api/job-status/{job_id} for progress."
                }

Completed Job Response (via /api/job-status/:job_id)

{
                  "success": true,
                  "job_id": "a5358a1c-388d-47a3-989e-755291031d77",
                  "job_type": "caption_remover",
                  "status": "completed",
                  "output_url": "https://audio.algrow.online/api/video/caption_remover_abc123.mp4",
                  "completed_at": 1774200779.08
                }

200 Queued 400 Missing video_url 401 Auth failed 402 No credits 403 Plan required 429 Too busy

POST /api/generate-image

Generate AI images from a text prompt. Supports multiple models with optional reference images. Returns one or more image URLs uploaded to CDN. Credits are deducted upfront and refunded automatically if generation fails. Set fast=true to bypass the standard ladder for sub-30s outputs (3× the model's base credits, minimum 3).

Request Body (JSON)

Name	Type	Required	Default	Description
prompt	string	Required	—	Text description of the image to generate
model	string	Optional	nano-banana-2	Image model. See model table below.
aspect_ratio	string	Optional	16:9	Output aspect ratio (e.g. `16:9`, `9:16`, `1:1`, `4:3`)
reference_image_url	string	Optional	—	URL of a reference image for style guidance. Required for `seedream-4.5-edit`.
reference_image_urls	array	Optional	—	Multiple reference image URLs. `nano-banana-pro` (up to 8), `nano-banana-2`, `seedream-5.0-lite`, and `gpt-image-2` use the whole list; single-reference models use the first URL. Takes precedence over `reference_image_url` when both are sent.
fast	boolean	Optional	false	Fast mode — bypasses the standard provider ladder for sub-30s outputs. Costs 3× the model's base credits (minimum 3). Same models and prompt; reference images still work.

Available Models

Model	Credits	Notes
`gpt-image-2`	0.35	OpenAI GPT Image 2 — text-to-image, or image-to-image when reference images are supplied. Flat price; outputs ~1.5K (e.g. 1536×1024, 1672×941 at 16:9)
`nano-banana-2`	1	Fast general-purpose generation (default)
`nano-banana-pro`	2	Higher quality, supports up to 8 reference images via `reference_image_urls`
`seedream-4.5-edit`	1	Image editing — requires `reference_image_url`
`seedream-5.0-lite`	1	Lightweight generation, optional reference

Example Request

curl -X POST "https://api.algrow.online/api/generate-image" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "a sunset over mountains, photorealistic", "model": "nano-banana-2", "aspect_ratio": "16:9"}'

Example Request (fast mode)

curl -X POST "https://api.algrow.online/api/generate-image" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "a sunset over mountains, photorealistic", "model": "nano-banana-2", "aspect_ratio": "16:9", "fast": true}'

Example Request (multiple reference images)

curl -X POST "https://api.algrow.online/api/generate-image" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "combine these into one product shot", "model": "nano-banana-pro", "reference_image_urls": ["https://example.com/ref1.png", "https://example.com/ref2.png"]}'

Response 200 200

{
                  "success": true,
                  "job_id": "536c20ce-5ee6-4b8d-9f7f-3994014c896e",
                  "status": "pending",
                  "credits_used": 1,
                  "message": "Image generation queued. Poll /api/job-status/{job_id} for progress."
                }

Completed Job Response (via /api/job-status/:job_id)

{
                  "success": true,
                  "job_id": "536c20ce-5ee6-4b8d-9f7f-3994014c896e",
                  "job_type": "image",
                  "status": "completed",
                  "image_urls": ["https://audio.algrow.online/api/images/user123/1774201509_0_5b0a0050.png"],
                  "completed_at": 1774201512.99
                }

200 Queued 400 Validation error 401 Auth failed 402 No credits 403 Plan required 429 Too busy

POST /api/generate-video

Generate AI videos from a text prompt. Supports multiple models including Sora, Kling, Grok, and Veo. Returns a video URL uploaded to CDN. Credits are deducted upfront and refunded automatically if generation fails.

Request Body (JSON)

Name	Type	Required	Default	Description
prompt	string	Required	—	Text description of the video to generate
model	string	Optional	sora-2	Video model. See model table below.
input_reference_url	string	Conditional	—	Reference image URL. Required for `kling-2.6`, `grok-image-to-video`, and `veo3-fast`.
seconds	string	Optional	4	Video duration in seconds (Sora only). Values: `4`, `8`, `12`
size	string	Optional	720x1280	Output resolution (Sora only). e.g. `720x1280`, `1280x720`
duration	string	Optional	5	Video duration (Kling only). Values: `5`, `10`
sound	boolean	Optional	false	Enable audio generation (Kling only). Doubles the credit cost.
aspect_ratio	string	Optional	9:16	Output aspect ratio (Veo only). e.g. `9:16`, `16:9`

Available Models

Model	Credits	Reference Image	Notes
`sora-2`	13 / 18 / 25	Optional	OpenAI Sora. Cost varies by duration: 4s / 8s / 12s
`kling-2.6`	8 – 30	Required	Image-to-video. Cost varies by duration and sound.
`grok-image-to-video`	3	Required	Grok image-to-video generation
`veo3-fast`	8	Required	Google Veo 3.1 Fast video generation

Example Request (Sora)

curl -X POST "https://api.algrow.online/api/generate-video" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "a cat walking through flowers", "model": "sora-2", "seconds": "4", "size": "720x1280"}'

Example Request (Kling with reference image)

curl -X POST "https://api.algrow.online/api/generate-video" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "person waving at camera", "model": "kling-2.6", "input_reference_url": "https://example.com/photo.jpg", "duration": "5"}'

Response 200 200

{
                  "success": true,
                  "job_id": "e58464d7-ae8d-41b2-8c52-79bac92b1bb9",
                  "status": "pending",
                  "credit_cost": 13,
                  "message": "Video generation queued. Poll /api/job-status/{job_id} for progress."
                }

Completed Job Response (via /api/job-status/:job_id)

{
                  "success": true,
                  "job_id": "e58464d7-ae8d-41b2-8c52-79bac92b1bb9",
                  "job_type": "video",
                  "status": "completed",
                  "video_url": "https://audio.algrow.online/sora/videos/user123/video_abc123.mp4",
                  "completed_at": 1774200881.01
                }

Processing time: Video generation can take 30 seconds to 30 minutes depending on the model and duration. Poll /api/job-status/:job_id every 5 seconds for updates.

200 Queued 400 Validation error 401 Auth failed 402 No credits 403 Plan required 429 Too busy

Buy More Credits