Pasar su propio contenido multimedia

Todo campo que acepta contenido multimedia (image_asset_id, reference_video_asset_ids, asset_id y cualquier otro *_asset_id o *_asset_ids) admite un id de recurso de su biblioteca o una URL HTTPS pública del archivo. Puede combinarlos libremente en una misma llamada. No hay un paso de subida aparte.

curl -s https://mcp.morphic.com/v1/direct/tools/edit_image \
  -H "Authorization: Bearer $MORPHIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "Put the bike on a beach at sunset", "image_asset_ids": ["https://cdn.example.com/products/bike.jpg"], "project_id": "01928f4e-…"}}'

Antes de que se ejecute la herramienta, cada URL se descarga y se añade a project_id como recurso subido, sin coste. Después, la herramienta trabaja con él como con cualquier otro recurso. Una URL necesita el permiso assets:write, y cada URL distinta cuenta como una llamada en el cupo de llamadas gratuitas.

• La URL debe ser HTTPS en un host público y servir el propio archivo, no una página web.
• Para un archivo de su propio almacenamiento, pase una URL firmada (un GET prefirmado de S3, una URL firmada de GCS). Manténgala válida hasta que la llamada responda.
• Se aceptan imágenes, video, audio y documentos (.pdf, .txt, .md, .srt). Se analizan los bytes, así que nunca se confía en la extensión.
• Un archivo multimedia puede ocupar hasta 100 MB, o el límite de subida de su plan si es menor, y debe llegar en un máximo de 25 segundos.
• Una URL que aparece dos veces en una misma llamada se descarga una sola vez. Una llamada posterior vuelve a descargarla; para reutilizar un archivo sin volver a descargarlo, pase el id de recurso que list_assets muestra para él.
• La entrada de la llamada se valida con el esquema de la herramienta antes de descargar ninguna URL. Una llamada mal formada responde 400 invalid_request y no descarga nada.
• Una URL que no se puede descargar o que no se acepta responde 422 tool_refused indicando el campo, por ejemplo input.image_asset_ids[0]: The URL must use https. No se inicia ni se cobra nada. Un archivo ya añadido permanece en el proyecto, igual que cuando la propia herramienta rechaza la llamada después.
• analyze_video y analyze_audio aceptan project_id solo para esto: envíelo cuando un campo multimedia contenga una URL.
• Los pasos de plan_media también aceptan URL, y cada una se añade al project_id de su paso, de modo que un presupuesto añade esos archivos a su biblioteca. Pase a los pasos que ejecute los ids de recurso que list_assets muestre entonces, en lugar de las URL, para descargar cada archivo una sola vez.

Si tiene algún problema o alguna pregunta, no dude en ponerse en contacto con nosotros. Estaremos encantados de ayudarle. Escríbanos a support@morphic.com.