About Topaz Astra
Creative video upscaling with new texture and detail, up to 4K.
Call it with the model name topaz/astra/upscale on POST /jobs/createTask, from $0.36.
Introduction
Astra is designed for shots whose finish can change during enlargement. An AI-generated interior or a stylized sequence may benefit from richer materials even if those materials are newly imagined. The task is therefore to approve a visual interpretation, including its treatment of people, rather than recover a definitive record of the scene.
Key features
Creative freedom has three levels, starting at low, and an optional written description can direct the scene’s appearance. The three output tiers are 720p, 1080p and 4K, leaving no intermediate 2K selection in this endpoint.
The no-prompt cellar run at low creativity added individual hair strands and more distinct glass boundaries, but also altered the woman’s eye and profile. Its three-second source took roughly two hundred ten seconds at 1080p. Even the restrained setting can therefore change meaningful facial detail, and a better-resolved still is only one part of evaluating the returned sequence.
Request parameters
| Parameter | Required | Description |
|---|---|---|
creativity_level | No | How much new detail is added. Low stays closest to your clip, High adds the most. low · medium · high · Default: low |
prompt | No | Describe what you want to make. |
resolution | No | Choose an available output size. 720p · 1080p · 4k · Default: 1080p |
video_url | Yes | The clip to work on. |
Pricing
Prices are in USD. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
| Option | USD per second |
|---|---|
| resolution 1080p | $0.36 |
| resolution 720p | $0.36 |
| resolution 4K | $0.60 |
Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.
Use cases
For a stylized film insert, use a selected interior take to explore a richer surface treatment. Compare clothing, glass and background materials with the intended art direction and with neighboring shots, where a change in visual finish may become conspicuous.
For AI video finishing, test the chosen take before creating all delivery sizes. Reject an appealing result if a recognizable face or important object drifts beyond what the project permits, even when the new texture looks attractive in isolation.
Prompt guide & pro tips
Establish an unprompted low pass before steering the image with text. If direction is needed, describe the visible subject, material and lighting in a coherent sentence; asking for unrelated objects makes the requested finish harder to judge against the supplied composition. Change one control at a time when comparing creative versions.
Watch turns of the head and movement around hair or glass across neighboring frames. Check that the added appearance remains useful throughout the take, then verify dimensions and the retained soundtrack.
API quick start
Call the Topaz Astra API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls use your separate USD balance.
- Send the request. POST /jobs/createTask with model topaz/astra/upscale and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "topaz/astra/upscale",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"resolution": "1080p",
"creativity_level": "low"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
Topaz Astra API questions
How much does the Topaz Astra API cost?
Topaz Astra costs $0.36 per second. Prices by option: 1080p $0.36 per second, 720p $0.36 per second, 4K $0.60 per second. The API uses a separate USD balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
What is the model name for Topaz Astra in the API?
Put topaz/astra/upscale for Upscale Video in the model field of POST /jobs/createTask.
What happens to the audio?
Astra keeps the original soundtrack synchronized with the shot; creative enlargement leaves the running time intact.
How do I choose the settings?
Begin without a prompt to see the source-led interpretation; use medium or high only when greater visual freedom serves the project.
What are the limits of the Topaz Astra API?
Resolutions: 720p · 1080p · 4K; Prompt length (characters): 2,000; Longest input clip: 60 s. Requests outside these limits are rejected before anything is charged.
Can I try Topaz Astra without writing code?
Run Topaz Astra in the Playground with your API USD balance, without an API key. Each run appears in your developer history with its matching code.
All Topaz models
- Topaz Bloom APICreative upscaling that adds new detail to AI art and illustrationsFrom $0.36 per image
- Topaz Denoise & Sharpen APIRemove noise or fix blur at the same resolution, up to 24 MPFrom $0.12 per image
- Topaz Gigapixel APIFaithful, generative or transparent upscales to 2K, 4K or 8KFrom $0.12 per image
- Topaz Astra APICreative video upscaling with new texture and detail, up to 4KFrom $0.36 per second
- Topaz Starlight APIGenerative repair that rebuilds detail in soft or compressed footage, up to 4KFrom $0.07 per second
- Topaz Video AI APIUpscale to 4K, remove noise or blur, convert to HDR, smooth or slow down motionFrom $0.002 per second