curl --request GET \
--url https://api.evolink.ai/v1/tasks/{task_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.evolink.ai/v1/tasks/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.evolink.ai/v1/tasks/{task_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.evolink.ai/v1/tasks/{task_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.evolink.ai/v1/tasks/{task_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.evolink.ai/v1/tasks/{task_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.evolink.ai/v1/tasks/{task_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"created": 1756817821,
"id": "task-unified-1756817821-4x3rx6ny",
"model": "gemini-3.1-flash-image-preview",
"object": "image.generation.task",
"progress": 100,
"results": [
"http://example.com/image.jpg"
],
"status": "completed",
"error": {
"code": "content_policy_violation",
"message": "Content policy violation.\nYour request was blocked by safety filters.",
"type": "task_error"
},
"task_info": {
"can_cancel": false
},
"type": "image"
}{
"error": {
"code": "invalid_task_id",
"message": "Invalid task ID format, must start with 'task-unified-'",
"type": "invalid_request_error",
"param": "task_id"
}
}{
"error": {
"code": "unauthorized",
"message": "Authentication required",
"type": "authentication_error"
}
}{
"error": {
"code": "quota_exceeded",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "permission_denied",
"message": "You don't have permission to access this task",
"type": "invalid_request_error"
}
}{
"error": {
"code": "task_not_found",
"message": "The requested task could not be found",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded",
"type": "evo_api_error"
}
}{
"error": {
"code": "internal_error",
"message": "Failed to retrieve task status",
"type": "api_error"
}
}Consultar Estado de Tarea
Consulta el estado, progreso e información de resultados de tareas asíncronas por ID de tarea
curl --request GET \
--url https://api.evolink.ai/v1/tasks/{task_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.evolink.ai/v1/tasks/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.evolink.ai/v1/tasks/{task_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.evolink.ai/v1/tasks/{task_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.evolink.ai/v1/tasks/{task_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.evolink.ai/v1/tasks/{task_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.evolink.ai/v1/tasks/{task_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"created": 1756817821,
"id": "task-unified-1756817821-4x3rx6ny",
"model": "gemini-3.1-flash-image-preview",
"object": "image.generation.task",
"progress": 100,
"results": [
"http://example.com/image.jpg"
],
"status": "completed",
"error": {
"code": "content_policy_violation",
"message": "Content policy violation.\nYour request was blocked by safety filters.",
"type": "task_error"
},
"task_info": {
"can_cancel": false
},
"type": "image"
}{
"error": {
"code": "invalid_task_id",
"message": "Invalid task ID format, must start with 'task-unified-'",
"type": "invalid_request_error",
"param": "task_id"
}
}{
"error": {
"code": "unauthorized",
"message": "Authentication required",
"type": "authentication_error"
}
}{
"error": {
"code": "quota_exceeded",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "permission_denied",
"message": "You don't have permission to access this task",
"type": "invalid_request_error"
}
}{
"error": {
"code": "task_not_found",
"message": "The requested task could not be found",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded",
"type": "evo_api_error"
}
}{
"error": {
"code": "internal_error",
"message": "Failed to retrieve task status",
"type": "api_error"
}
}Autorizaciones
##Todas las APIs requieren autenticación Bearer Token##
Obtener API Key:
Visita la Página de gestión de API Key para obtener tu API Key
Agregar al encabezado de la solicitud:
Authorization: Bearer YOUR_API_KEY
Parámetros de ruta
ID de tarea, ignora {} al consultar, agrega el id del cuerpo de respuesta de la tarea asíncrona al final de la ruta
Respuesta
Detalles del estado de la tarea
Marca de tiempo de creación de la tarea
1756817821
ID de tarea
"task-unified-1756817821-4x3rx6ny"
Modelo utilizado
"gemini-3.1-flash-image-preview"
Tipo de tarea
image.generation.task, video.generation.task, audio.generation.task "image.generation.task"
Porcentaje de progreso de la tarea
0 <= x <= 100100
Lista de resultados de la tarea (proporcionada al completarse)
["http://example.com/image.jpg"]
Estado de la tarea
pending, processing, completed, failed "completed"
Informacion de error cuando la tarea falla (solo presente cuando status es "failed"). Nota: error.code aqui es un codigo de error de negocio de tipo string, diferente de los codigos de estado HTTP. Consulte la Referencia de Codigos de Error para la lista completa.
Show child attributes
Show child attributes
Información detallada de la tarea
Show child attributes
Show child attributes
Tipo de tarea
image, video, audio, text "image"