curl --request GET \
--url https://api.creatify.ai/api/boreal/ \
--header 'X-API-ID: <api-key>' \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.creatify.ai/api/boreal/"
headers = {
"X-API-ID": "<api-key>",
"X-API-KEY": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-ID': '<api-key>', 'X-API-KEY': '<api-key>'}};
fetch('https://api.creatify.ai/api/boreal/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.creatify.ai/api/boreal/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-ID: <api-key>",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.creatify.ai/api/boreal/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-ID", "<api-key>")
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.creatify.ai/api/boreal/")
.header("X-API-ID", "<api-key>")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.creatify.ai/api/boreal/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-ID"] = '<api-key>'
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"prompt": "<string>",
"expires_at": "<string>",
"status": "pending",
"failed_reason": "<string>",
"video_output": "<string>",
"credits_used": 123,
"progress": 123,
"model": "boreal",
"image_url": "<string>",
"end_image_url": "<string>",
"audio_url": "<string>",
"reference_image_urls": [
"<string>"
],
"reference_video_urls": [
"<string>"
],
"reference_audio_urls": [
"<string>"
],
"resolution": "720p",
"aspect_ratio": "auto",
"duration": 10,
"negative_prompt": "<string>",
"prompt_enhancement": "auto",
"ttl_days": 4,
"webhook_url": "<string>"
}
]Get Boreal items
Retrieve a list of records. Optionally filter by ids (UUIDs) and/or a creation time window [created_after, created_before). The window selects records by when they were created; status and credits_used reflect their current state and can change until the job finishes (failed jobs are refunded and report 0 credits).
curl --request GET \
--url https://api.creatify.ai/api/boreal/ \
--header 'X-API-ID: <api-key>' \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.creatify.ai/api/boreal/"
headers = {
"X-API-ID": "<api-key>",
"X-API-KEY": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-ID': '<api-key>', 'X-API-KEY': '<api-key>'}};
fetch('https://api.creatify.ai/api/boreal/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.creatify.ai/api/boreal/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-ID: <api-key>",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.creatify.ai/api/boreal/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-ID", "<api-key>")
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.creatify.ai/api/boreal/")
.header("X-API-ID", "<api-key>")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.creatify.ai/api/boreal/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-ID"] = '<api-key>'
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"prompt": "<string>",
"expires_at": "<string>",
"status": "pending",
"failed_reason": "<string>",
"video_output": "<string>",
"credits_used": 123,
"progress": 123,
"model": "boreal",
"image_url": "<string>",
"end_image_url": "<string>",
"audio_url": "<string>",
"reference_image_urls": [
"<string>"
],
"reference_video_urls": [
"<string>"
],
"reference_audio_urls": [
"<string>"
],
"resolution": "720p",
"aspect_ratio": "auto",
"duration": 10,
"negative_prompt": "<string>",
"prompt_enhancement": "auto",
"ttl_days": 4,
"webhook_url": "<string>"
}
]Authorizations
Query Parameters
Response
- object[]
- object
boreal (default) or boreal-h3, Creatify's post-trained H3 model. boreal-h3 renders 768p, 1088p or 2k, 1 to 15 seconds, and adds a closing frame (end_image_url) and reference-to-video (reference_*_urls); it takes no audio_url or negative_prompt.
boreal- Borealboreal-h3- Boreal H3
boreal, boreal-h3 boreal-h3 only: up to 3 reference videos for reference-to-video, billed on top of the output per second of their combined length (counted up to 15 seconds): 0.4 credits at 768p, 0.6 at 1088p and 2k. The whole boreal-h3 price is rounded up to half a credit.
32000Delivery tier. boreal: 720p (default), 1080p or 2k, where 2k is 2016 px on the long edge for 16:9 and 9:16, and the 1440p row for 1:1, 4:3 and 3:4; each started 10 seconds of video costs 1, 3 or 12 credits. boreal-h3: 768p (default), 1088p or 2k, where 2k is a 1440 px short edge; each second costs 0.4, 1.2 or 2.6 credits, plus any reference inputs, the same as on the asset generator API.
720p- 720p1080p- 1080p2k- 2k768p- 768p1088p- 1088p
720p, 1080p, 2k, 768p, 1088p Frame ratio. auto follows the start image's own ratio (boreal-h3: the first reference image's), and is 16:9 without an image. A named ratio renders that ratio; with a start image, boreal centre-crops the image to it, and boreal-h3 takes only auto.
auto- auto16:9- 16:99:16- 9:161:1- 1:14:3- 4:33:4- 3:4
auto, 16:9, 9:16, 1:1, 4:3, 3:4 boreal-h3 only. auto (default) or ads rewrites the prompt for an ad, the way boreal-h3 was evaluated; general rewrites it for any other video, toward what Seedance 2.5 makes from the same prompt; none renders it as sent. boreal always renders the prompt as sent.
auto- autoads- adsnone- nonegeneral- general
auto, ads, none, general 
