AI Character Consistency API — Keep Characters Consistent

¿Qué es una API de consistencia de personajes?

Una API de coherencia de personajes utiliza una o más imágenes de referencia para reproducir el mismo sujeto en nuevas escenas, poses, atuendos y ángulos de cámara. Los modelos de referencia de imágenes son útiles para hojas de personajes y fotografías; Los modelos de referencia a vídeo ponen en movimiento esa identidad.

Muapi expone a ambas familias a través del mismo flujo de envío y encuesta REST. Elija un modelo por tamaño de paquete de referencia, modalidad de entrada, precio o si la salida debe ser una imagen o un video.

Capacidades clave

Comparativa de modelos de consistencia de personajes

Los límites de referencia, las modalidades admitidas y los precios varían según el modelo. Verifique el esquema Playground de cada modelo antes de enviar solicitudes de producción.

Cómo invocar la API de consistencia de personajes

1. Choose an image or video model. Select a model based on output type, reference-pack size, modality, and budget.
2. Host your references. Cargue imágenes de origen a través de POST /api/v1/upload_file o utilice URL de acceso público aceptadas por el punto final seleccionado.
3. Send the task-type fields. Llame a POST /api/v1/{model-slug} con imágenes_list, un mensaje y cualquier referencia específica del modelo o campos de tipo de tarea.
4. Encuesta y persiste el resultado. Verifique GET /api/v1/predictions/{request_id}/result hasta que se complete el estado, luego almacene la imagen o el video devuelto.

curl -X POST https://api.muapi.ai/api/v1/seedance-2.5-omni-reference \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "images_list": [
      "https://example.com/character-front.jpg",
      "https://example.com/character-side.jpg"
    ],
    "prompt": "the character walking through a neon-lit city street at night",
    "omni_reference_task_type": "reference",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

import requests

response = requests.post(
    "https://api.muapi.ai/api/v1/seedance-2.5-omni-reference",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "images_list": [
            "https://example.com/character-front.jpg",
            "https://example.com/character-side.jpg",
        ],
        "prompt": "the character walking through a neon-lit city street at night",
        "omni_reference_task_type": "reference",
        "duration": 5,
        "aspect_ratio": "16:9",
    },
)
request_id = response.json()["request_id"]

result = requests.get(
    f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())

Preguntas frecuentes