Proceso de solicitud
Para utilizar la API de SeeDream Images Generation, primero dirígete a la consola de Ace Data Cloud para obtener tu token de API, que debes guardar como respaldo.
Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión; una vez completado, volverás automáticamente a la página actual.
Un token de API es suficiente para acceder a todos los servicios de la plataforma, sin necesidad de solicitar uno por cada servicio. La primera solicitud te otorgará un crédito gratuito para que puedas probarlo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.
📘 Documentación completa: API de SeeDream Images Generation →
Ejemplo de solicitud
La API de SeeDream Tasks se puede utilizar para consultar los resultados de la API de SeeDream Images Generation. Para saber cómo utilizar la API de SeeDream Images Generation, consulta la documentación API de SeeDream Images Generation. Tomemos como ejemplo un ID de tarea devuelto por el servicio de API de SeeDream Images Generation, y demostraremos cómo utilizar esta API. Supongamos que tenemos un ID de tarea: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0, a continuación, demostraremos cómo pasar un ID de tarea.Ejemplo de tarea
Configuración de encabezados de solicitud y cuerpo de solicitud
Request Headers incluye:accept: especifica que se aceptan respuestas en formato JSON, aquí se debe llenar comoapplication/json.authorization: la clave para llamar a la API, que puedes seleccionar directamente después de solicitarla.
id: el ID de tarea cargado.action: el método de operación sobre la tarea.
Ejemplo de código
Se puede observar que en el lado derecho de la página se han generado automáticamente códigos en varios lenguajes, como se muestra en la imagen:
CURL
Ejemplo de respuesta
Después de una solicitud exitosa, la API devolverá la información detallada de la tarea aquí. Por ejemplo:success, el estado de la tarea de generación de video en este momento.task_id, el ID de la tarea de generación de video en este momento.trace_id, el ID de seguimiento de la generación de video en este momento.data, la lista de resultados de la tarea de generación de imágenes en este momento.image_url, el enlace de la tarea de generación de imágenes en este momento.prompt, la palabra clave.size: los píxeles de la imagen generada.
Operación de consulta por lotes
Esto es para consultar los detalles de varias tareas ID, a diferencia de lo anterior, se debe seleccionar la acción como retrieve_batch. Request Body incluye:ids: un array de IDs de tarea cargados.action: el método de operación sobre la tarea.
Ejemplo de código
Algunos ejemplos de código son los siguientes:Ejemplo de respuesta
Después de una solicitud exitosa, la API devolverá la información detallada de todas las tareas por lotes en esta ocasión. Por ejemplo:items incluye los detalles específicos de las tareas por lotes, cada tarea tiene la misma información de campo que el resultado de la consulta de una sola tarea anterior.
items, todos los detalles específicos de la tarea por lotes. Es un arreglo, cada elemento del arreglo tiene el mismo formato que el resultado de la consulta de una sola tarea anterior.count, el número de tareas en esta consulta por lotes.
created_at, hora de creación de la tarea, marca de tiempo Unix (segundos, flotante).started_at, hora de inicio de la ejecución de la tarea, marca de tiempo Unix (segundos, flotante).finished_at, hora de finalización de la tarea, marca de tiempo Unix (segundos, flotante). Este campo no se devuelve si la tarea no se ha completado.elapsed, tiempo de ejecución de la tarea, en segundos (flotante, con 3 decimales). Este campo no se devuelve si la tarea no se ha completado.
CURL
Manejo de errores
Al llamar a la API, si se encuentra un error, la API devolverá el código de error correspondiente y la información. Por ejemplo:400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.401 invalid_token: No autorizado, token de autorización inválido o faltante.429 too_many_requests: Demasiadas solicitudes, ha superado el límite de tasa.500 api_error: Error interno del servidor, algo salió mal en el servidor.