google/lyria cria música a partir de texto em /v1/music/generations. Pode pedir um fundo instrumental discreto para demonstração de produto, descrevendo instrumentos principais e espaço necessário à narração. Escolha esta rota quando o resultado pretendido for um excerto musical gerado.
O pedido exige model e prompt. n ou count aceita 1 a 8 excertos e o método devolve o resultado sincronamente. Guarde todos os excertos e metadados reais. Não expõe referência áudio, duração ou andamento como controlos independentes. Descreva a intenção musical no prompt sem a tratar como propriedade medida garantida da saída.
", "aboutText": "google/lyria cria música a partir de texto em /v1/music/generations. Pode pedir um fundo instrumental discreto para demonstração de produto, descrevendo instrumentos principais e espaço necessário à narração. Escolha esta rota quando o resultado pretendido for um excerto musical gerado. O pedido exige model e prompt. n ou count aceita 1 a 8 excertos e o método devolve o resultado sincronamente. Guarde todos os excertos e metadados reais. Não expõe referência áudio, duração ou andamento como controlos independentes. Descreva a intenção musical no prompt sem a tratar como propriedade medida garantida da saída.", "editorialOverlay": { "copy_fields": { "about_html": "google/lyria cria música a partir de texto em /v1/music/generations. Pode pedir um fundo instrumental discreto para demonstração de produto, descrevendo instrumentos principais e espaço necessário à narração. Escolha esta rota quando o resultado pretendido for um excerto musical gerado.
O pedido exige model e prompt. n ou count aceita 1 a 8 excertos e o método devolve o resultado sincronamente. Guarde todos os excertos e metadados reais. Não expõe referência áudio, duração ou andamento como controlos independentes. Descreva a intenção musical no prompt sem a tratar como propriedade medida garantida da saída.
", "short_text": "Geração musical por texto, com 1 a 8 excertos pedidos e entrega síncrona do resultado." }, "copy_sha256": "d707cdb0169dec12d1c601fe78c867aaa4ea849878c551d5825ec6c4811bba50", "copy_source": { "locale": "pt-pt", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "1ef986c63e164711cfe7fb6a5994521f10df57f9990934d6c764ef69ef3fa7da", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "51fe25cb89f9abf5a6e63631b36f96e4a0b7a7fa5353cb5bfdd98ca79e3108b1", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pt-pt", "methods": [ { "html": "google/lyriaGeração musical por texto, com 1 a 8 excertos pedidos e entrega síncrona do resultado.
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
google/lyria cria música a partir de texto em /v1/music/generations. Pode pedir um fundo instrumental discreto para demonstração de produto, descrevendo instrumentos principais e espaço necessário à narração. Escolha esta rota quando o resultado pretendido for um excerto musical gerado.
O pedido exige model e prompt. n ou count aceita 1 a 8 excertos e o método devolve o resultado sincronamente. Guarde todos os excertos e metadados reais. Não expõe referência áudio, duração ou andamento como controlos independentes. Descreva a intenção musical no prompt sem a tratar como propriedade medida garantida da saída.
POST /v1/music/generationstextmusic| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites google/lyria | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 | Predefinição— |
Campon | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 8 | Predefinição1 |
Campocount | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 8 Condições: Se n também for fornecido, a contagem tem de coincidir | Predefinição— |
text_to_music · Obrigatório: prompt
| Parâmetro | Contrato |
|---|---|
Parâmetromaterial_types | Contratotext |
Parâmetrorequired | Contratonull |
Parâmetrooptional_controls | Contratonull |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id efetivamente devolvido ou registo na biblioteca de multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
As estruturas dos métodos e os ID são exatos; a capacidade do fornecedor é distinta da admissão dos pedidos.
POST /v1/music/generationsClipes entregues × tarifa base por clipe. A referência por pedido não é somada. Exemplos antes dos ajustes aplicáveis.
1 × 0,08 US$ = 0,08 US$
4 × 0,08 US$ = 0,32 US$
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/lyria", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nexport AILOOT_API_KEY\npython3 - <<'PY_RESULT'\nimport json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin, urlparse\nresult=json.loads(Path("result.json").read_text(encoding="utf-8"))\nprint(json.dumps(result,ensure_ascii=False,indent=2))\nfor number,clip in enumerate(result.get("data") or []):\n u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))\n if u.scheme!="https" or not u.hostname or u.username or u.password:\n raise SystemExit("Result URL must be HTTPS without embedded credentials")\n owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n raw=subprocess.check_output(args)\n ext="wav" if raw.startswith(b"RIFF") and raw[8:12]==b"WAVE" else "flac" if raw.startswith(b"fLaC") else "ogg" if raw.startswith(b"OggS") else "mp3" if raw.startswith(b"ID3") or raw[:1]==b"\\xff" else "bin"\n f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)\n print("Saved",f,clip.get("asset_id"))\n\nPY_RESULT\nexcertos completos de áudio pertencentes ao utilizador / ligações JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Guarde cada resposta, ficheiro e parte de conteúdo devolvidos na íntegra.
Guarde/obtenha todos os excertos devolvidos e conserve o ID, MIME e metadados reais. O método é síncrono; não introduz um URL separado de consulta periódica da geração de música da Ailoot.
Se um resultado de música precisar de verificação, conserve o operation_id/X-Client-Request-ID original e a informação dos excertos devolvidos. Recupere os excertos existentes que pertencem ao utilizador através da biblioteca multimédia, utilizando os valores reais de task_id ou asset_id. Não volte a enviar o pedido de música nem construa um URL de consulta periódica da geração a partir de operation_id.
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Camporesponse_id | Tipostring |
Campodata[] | Tipoowned clip record |
| Resposta | Condição | Passo seguinte |
|---|---|---|
Resposta400 · invalid_request_error | CondiçãoCampos obrigatórios, representação do material ou valor do parâmetro inválidos | Passo seguinteCorrija os campos indicados antes de um novo pedido de criação. |
Respostaserver_error | CondiçãoA resposta devolvida indica que a operação ou o resultado requer verificação | Passo seguinteGuarde o ID original da operação/tarefa devolvido, os cabeçalhos do pedido e a resposta; continue a consultar essa operação original através das consultas suportadas. Não volte a enviar o pedido de criação. |
Ailoot google/lyria
Use os caminhos dos métodos indicados acima.