curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
import requests
url = "https://api.apimart.ai/v1/videos/generations"
payload = {
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const url = "https://api.apimart.ai/v1/videos/generations";
const payload = {
model: "gemini-omni-1.1-flash",
prompt: "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
aspect_ratio: "16:9",
resolution: "1080p"
};
const headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
package main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://api.apimart.ai/v1/videos/generations"
payload := map[string]interface{}{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p",
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KS1H7ZYSJWH1N779S2FSHTKA"
}
]
}
{
"error": {
"code": 400,
"message": "Parâmetros de solicitação inválidos",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Falha na autenticação. Verifique sua chave de API",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Saldo insuficiente. Adicione créditos e tente novamente",
"type": "payment_required"
}
}
{
"error": {
"code": 429,
"message": "Muitas solicitações. Tente novamente mais tarde",
"type": "rate_limit_error"
}
}
Gemini Omni 1.1 Flash
Geração de vídeo Gemini Omni 1.1 Flash
- Modelo oficial do Google Gemini Omni 1.1 Flash para geração de vídeo multimodal completa
- Suporta texto para vídeo, imagem para vídeo, referências de múltiplos sujeitos, interpolação do primeiro e último quadro, edição e extensão de vídeo
- Suporta 360p / 720p / 1080p / 4K, 24 fps e saídas de 3–10 segundos com áudio gerado
- API de tarefa assíncrona; consulte o resultado pelo ID da tarefa após o envio
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
import requests
url = "https://api.apimart.ai/v1/videos/generations"
payload = {
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const url = "https://api.apimart.ai/v1/videos/generations";
const payload = {
model: "gemini-omni-1.1-flash",
prompt: "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
aspect_ratio: "16:9",
resolution: "1080p"
};
const headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
package main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://api.apimart.ai/v1/videos/generations"
payload := map[string]interface{}{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p",
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KS1H7ZYSJWH1N779S2FSHTKA"
}
]
}
{
"error": {
"code": 400,
"message": "Parâmetros de solicitação inválidos",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Falha na autenticação. Verifique sua chave de API",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Saldo insuficiente. Adicione créditos e tente novamente",
"type": "payment_required"
}
}
{
"error": {
"code": 429,
"message": "Muitas solicitações. Tente novamente mais tarde",
"type": "rate_limit_error"
}
}
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
import requests
url = "https://api.apimart.ai/v1/videos/generations"
payload = {
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const url = "https://api.apimart.ai/v1/videos/generations";
const payload = {
model: "gemini-omni-1.1-flash",
prompt: "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
aspect_ratio: "16:9",
resolution: "1080p"
};
const headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
package main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://api.apimart.ai/v1/videos/generations"
payload := map[string]interface{}{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p",
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KS1H7ZYSJWH1N779S2FSHTKA"
}
]
}
{
"error": {
"code": 400,
"message": "Parâmetros de solicitação inválidos",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Falha na autenticação. Verifique sua chave de API",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Saldo insuficiente. Adicione créditos e tente novamente",
"type": "payment_required"
}
}
{
"error": {
"code": 429,
"message": "Muitas solicitações. Tente novamente mais tarde",
"type": "rate_limit_error"
}
}
Autenticação
string
obrigatório
Todas as APIs exigem autenticação com Bearer Token.Obter uma chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave.Adicione-a ao cabeçalho da solicitação:
Authorization: Bearer YOUR_API_KEY
Parâmetros da solicitação
string
obrigatório
Nome do modelo de geração de vídeo. Deve ser
gemini-omni-1.1-flash.string
Instrução textual. Para texto para vídeo, descreva a cena. Para imagem para vídeo, edição ou extensão, descreva o movimento, o estilo ou a alteração desejada.
Forneça pelo menos
prompt ou mídia (image_urls, imagens do primeiro/último quadro ou video_urls).string
padrão:"720p"
Resolução do vídeo de saída. Não diferencia maiúsculas de minúsculas.Valores disponíveis:
360p720p(padrão)1080p4k
2160p é tratado como 4k. A resolução determina a faixa de depósito pré-cobrado e o principal custo da saída de vídeo.Uma resolução não suportada retorna o erro
invalid_resolution.string
padrão:"16:9"
Proporção do vídeo, usada para selecionar saída horizontal ou vertical.Suportado:
16:9- Horizontal (padrão)9:16- Vertical
16:9.Ao fornecer
video_urls, a saída normalmente segue a proporção do vídeo de entrada; portanto, aspect_ratio pode não ser aplicado.array<string>
Array de imagens de referência. Somente URLs HTTP/HTTPS publicamente acessíveis são suportadas.
- Fornecer 1 imagem: usada como quadro inicial do vídeo por padrão
- Fornecer várias imagens: usadas como referências de sujeitos ou estilo; descreva a finalidade e a relação de cada imagem em
prompt
image_urls e as imagens do primeiro/último quadro podem conter no máximo 10 imagens no total.string
Imagem do primeiro quadro. Somente uma URL HTTP/HTTPS publicamente acessível é suportada.
- Fornecida sozinha: usa a imagem como quadro inicial do vídeo
- Fornecida com
last_frame_image: gera uma transição suave do primeiro para o último quadro
string
Imagem do último quadro. Somente uma URL HTTP/HTTPS publicamente acessível é suportada e deve ser fornecida com
first_frame_image.Fornecer apenas
last_frame_image retorna invalid_frame_images. Use a mesma proporção nas duas imagens e faça-a corresponder a aspect_ratio.Para o primeiro quadro ou o par primeiro/último quadro, os métodos abaixo têm o mesmo efeito. Escolha um e não forneça ambos:
- Usar
first_frame_image/last_frame_image - Usar
image_with_rolescomroledefinido comofirst_frame/last_frame
array<object>
Array de imagens com funções. É uma alternativa equivalente a
Exemplo:
first_frame_image / last_frame_image e também pode declarar imagens de referência.Mostrar Elemento de image_with_roles
Mostrar Elemento de image_with_roles
string
obrigatório
URL HTTP/HTTPS de imagem publicamente acessível.
string
obrigatório
Função da imagem:
first_frame: primeiro quadrolast_frame: último quadro; um primeiro quadro também deve estar presentereference: imagem de referência; outras funções que não sejam primeiro ou último quadro também são tratadas como referência
[
{"url": "https://example.com/start.jpg", "role": "first_frame"},
{"url": "https://example.com/end.jpg", "role": "last_frame"}
]
Se
image_urls também for fornecido, ele terá prioridade para referências e não será combinado com referências em image_with_roles. Todas as imagens efetivamente usadas, incluindo o primeiro e o último quadro, são limitadas a 10 no total.array<string>
Array de vídeos para editar ou estender. Atualmente, é aceito no máximo um vídeo com até 10 segundos.Somente URLs HTTP/HTTPS diretas e publicamente acessíveis são suportadas. Links do YouTube não são suportados.
video_urls e extend_from_task_id são mutuamente exclusivos. Forneça apenas um.object
Objeto de parâmetros adicionais para especificar explicitamente a intenção de geração.
Mostrar Campos de metadata
Mostrar Campos de metadata
string
Tipos de tarefa disponíveis:
text_to_video: texto para vídeoimage_to_video: imagem para vídeoreference_to_video: referência para vídeoedit: edição de vídeoextend: extensão de vídeo
Na interpolação do primeiro e último quadro, o modelo infere a tarefa automaticamente e a plataforma não envia
metadata.task.string
task_id local da tarefa de geração anterior. Use-o para edição conversacional ou extensão adicional sem reenviar o vídeo anterior.A tarefa referenciada deve pertencer ao usuário atual, ter sido concluída com sucesso e usar um modelo Gemini Omni.extend_from_task_id e video_urls são mutuamente exclusivos. Forneça apenas um.Este modelo não possui o parâmetro
duration. A duração de cada saída é definida automaticamente conforme o conteúdo, geralmente entre 3 e 10 segundos. Para controlar o ritmo, descreva-o em prompt com linguagem natural ou intervalos de tempo.Resposta
integer
Código de resposta.
200 indica sucesso.array
Consultar o resultado da tarefa
A geração de vídeo é assíncrona. Após receber otask_id, use a API Obter status da tarefa para consultar o progresso e o resultado.
cURL
curl --request GET \
--url https://api.apimart.ai/v1/tasks/task_01KS1H7ZYSJWH1N779S2FSHTKA \
--header 'Authorization: Bearer <token>'
completed ou failed. Recomenda-se um tempo limite total de 10 minutos no cliente.
Exemplo de resultado bem-sucedido
{
"code": 200,
"data": {
"id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
"status": "completed",
"progress": 100,
"cost": 1.52,
"credits_cost": 15.2,
"result": {
"videos": [
{
"url": ["https://cdn.example.com/gemini_omni_xxx.mp4"],
"expires_at": 1788518400
}
]
}
}
}
Casos de uso
Caso 1: texto para vídeo (4K)
{
"model": "gemini-omni-1.1-flash",
"prompt": "a blue butterfly landing on a flower, macro, soft light, no dialogue",
"aspect_ratio": "9:16",
"resolution": "4k"
}
Caso 2: interpolação do primeiro e último quadro
{
"model": "gemini-omni-1.1-flash",
"prompt": "smooth transition, camera slowly pushes in",
"first_frame_image": "https://example.com/start.jpg",
"last_frame_image": "https://example.com/end.jpg",
"resolution": "720p"
}
Caso 3: referências de múltiplos sujeitos
{
"model": "gemini-omni-1.1-flash",
"prompt": "the cat playfully bats at the ball of yarn",
"image_urls": [
"https://example.com/cat.png",
"https://example.com/yarn.png"
],
"resolution": "720p"
}
Caso 4: declarar o primeiro e o último quadro com funções de imagem
{
"model": "gemini-omni-1.1-flash",
"prompt": "a smooth cinematic transition from sunrise to a starry night",
"image_with_roles": [
{"url": "https://example.com/sunrise.jpg", "role": "first_frame"},
{"url": "https://example.com/night.jpg", "role": "last_frame"}
],
"resolution": "1080p"
}
Caso 5: edição de vídeo
{
"model": "gemini-omni-1.1-flash",
"prompt": "Make the violin invisible. Keep everything else the same.",
"video_urls": ["https://example.com/clip.mp4"]
}
Keep everything else the same para preservar a consistência do restante.
Caso 6: extensão conversacional
{
"model": "gemini-omni-1.1-flash",
"prompt": "Extend this video: the camera pans across the mountains.",
"extend_from_task_id": "task_01AAA"
}