curl -X POST "https://api.tokenlab.sh/v1/worlds/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "marble-1.1",
"prompt": "Uma cidade costeira tranquila ao pôr do sol com vielas estreitas e luzes quentes"
}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={
"model": "marble-1.1",
"prompt": "Uma cidade costeira tranquila ao pôr do sol com vielas estreitas e luzes quentes",
},
)
task = response.json()
print(task["id"], task["poll_url"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'marble-1.1',
prompt: 'Uma cidade costeira tranquila ao pôr do sol com vielas estreitas e luzes quentes'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
{
"id": "<string>",
"task_id": "<string>",
"operation_id": "<string>",
"status": "pending",
"poll_url": "<string>",
"world_id": "<string>",
"world_marble_url": "<string>",
"model_url": "<string>",
"glb_url": "<string>",
"pano_url": "<string>",
"thumbnail_url": "<string>",
"caption": "<string>",
"cost": {}
}Worlds
Criar World
Cria uma tarefa de geração de mundo World Labs Marble
POST
/
v1
/
worlds
/
generations
curl -X POST "https://api.tokenlab.sh/v1/worlds/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "marble-1.1",
"prompt": "Uma cidade costeira tranquila ao pôr do sol com vielas estreitas e luzes quentes"
}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={
"model": "marble-1.1",
"prompt": "Uma cidade costeira tranquila ao pôr do sol com vielas estreitas e luzes quentes",
},
)
task = response.json()
print(task["id"], task["poll_url"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'marble-1.1',
prompt: 'Uma cidade costeira tranquila ao pôr do sol com vielas estreitas e luzes quentes'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
{
"id": "<string>",
"task_id": "<string>",
"operation_id": "<string>",
"status": "pending",
"poll_url": "<string>",
"world_id": "<string>",
"world_marble_url": "<string>",
"model_url": "<string>",
"glb_url": "<string>",
"pano_url": "<string>",
"thumbnail_url": "<string>",
"caption": "<string>",
"cost": {}
}Gere mundos 3D exploráveis com World Labs Marble. Esta API é assíncrona: respostas de criação retornam uma identidade de tarefa e uma
poll_url para verificar status.
Escolha um modelo Marble disponível atualmente pela Models API.
Corpo da requisição
string
padrão:"marble-1.0"
Escolha um modelo Marble disponível atualmente pela Models API.
string
Prompt de texto para geração somente texto ou como guia com entradas de imagem/vídeo.
object
Objeto nativo World Labs
world_prompt para chamadas avançadas. Tipos suportados: text, image, multi-image e video.string
Prompt de imagem em Base64 ou data URL.
string
Prompt por URL de imagem.
array
Vários prompts de imagem para geração multi-image rápida. Forneça até 4 imagens. Para o modo de reconstrução nativo da World Labs, envie
world_prompt.type="multi-image" com reconstruct_images: true e até 8 imagens.string
Prompt por URL de vídeo.
boolean | string
Para entradas de imagem, use
true para panorama existente, false para imagem única normal, ou auto.integer
Seed opcional de 0 a 4294967295.
string
Nome de exibição opcional para o mundo gerado, até 64 caracteres.
array
Tags opcionais da World Labs. Até 10 tags, cada uma com até 32 caracteres.
object
Configurações opcionais de visibilidade e acesso:
public, allow_id_access, allowed_readers e allowed_writers. public: true solicita um mundo visível publicamente.Resposta
string
ID público da tarefa para polling.
string
Alias do identificador de tarefa assíncrona.
string
ID da operação da World Labs.
string
URL de polling preferida para esta tarefa.
string
Status da tarefa:
pending, processing, completed ou failed.string
URL do mundo Marble gerado quando concluído.
string
URL GLB da malha collider quando disponível.
string
URL da imagem panorâmica quando disponível.
Preços
Consulte a Pricing API para ver as tarifas atuais. O valor faturado aparece nos registros de uso; o valor retornado emcost.total_credits indica uso de geração, não uma quantia em moeda.
curl -X POST "https://api.tokenlab.sh/v1/worlds/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "marble-1.1",
"prompt": "Uma cidade costeira tranquila ao pôr do sol com vielas estreitas e luzes quentes"
}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={
"model": "marble-1.1",
"prompt": "Uma cidade costeira tranquila ao pôr do sol com vielas estreitas e luzes quentes",
},
)
task = response.json()
print(task["id"], task["poll_url"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'marble-1.1',
prompt: 'Uma cidade costeira tranquila ao pôr do sol com vielas estreitas e luzes quentes'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
Autorizações
Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Cabeçalhos
Política de entrega por requisição. Substitui os padrões da API key e do Workspace. Tenta automaticamente o TokenLab Verified primeiro e pode alternar uma vez para Official apenas antes da saída, aceitação upstream ou criação de recurso persistente.
Opções disponíveis:
auto, verified, official Corpo
application/json
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
Objeto world_prompt nativo do World Labs para chamadores avançados. Os tipos de prompt suportados são text, image, multi-image e video. Referências de conteúdo podem usar source=media_asset com um media_asset_id preparado por /v1/worlds/media-assets/prepare-upload.
Modelo Marble a ser usado. O padrão é marble-1.0 para corresponder ao padrão de compatibilidade atual do World Labs quando o modelo é omitido.
Opções disponíveis:
marble-1.0, marble-1.1, marble-1.1-plus Prompt de texto usado para geração de mundo por texto ou imagem/vídeo guiado.
Nome de exibição opcional para o mundo gerado, até 64 caracteres.
Maximum string length:
64Prompt de imagem em Base64 ou URL de dados.
Prompt de URL de imagem.
Atalhos para prompts de múltiplas imagens. Forneça até 4 imagens. Use world_prompt.reconstruct_images=true nativo para até 8 imagens.
Maximum array length:
4Prompt de URL de vídeo.
Se um prompt de imagem é um panorama existente. Use true para entrada pano, false para entrada de imagem única ou auto.
Seed opcional de 0 a 4294967295.
Intervalo necessário:
0 <= x <= 4294967295Tags opcionais do World Labs. Forneça até 10 tags, cada uma com até 32 caracteres.
Maximum array length:
10Maximum string length:
32Objeto de permissão opcional do World Labs.
Identificador do usuário final.