Get Task Info

Query the status and results of all model generation tasks.

curl --request GET \
  --url https://api.crun.ai/api/v1/client/job/TaskInfo \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.crun.ai/api/v1/client/job/TaskInfo"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.crun.ai/api/v1/client/job/TaskInfo', 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.crun.ai/api/v1/client/job/TaskInfo",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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.crun.ai/api/v1/client/job/TaskInfo"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	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.crun.ai/api/v1/client/job/TaskInfo")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.crun.ai/api/v1/client/job/TaskInfo")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "running",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": null,
    "credits": 3,
    "duration_s": null,
    "complete_at": null,
    "source": "api"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "success",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": {
      "code": 200,
      "message": "generation success",
      "media_urls": [
        "https://example.com/example.png"
      ],
      "usage": {
        "prompt_tokens": 126,
        "completion_tokens": 32,
        "total_tokens": 158
      }
    },
    "credits": 3,
    "duration_s": 137,
    "complete_at": 1768900515,
    "source": "api"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "failed",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": {
      "code": 501,
      "message": "generation failed"
    },
    "credits": 0,
    "duration_s": 137,
    "complete_at": 1768900515,
    "source": "api"
  }
}

GET

api

client

job

TaskInfo

Query the status and results of all model generation tasks.

curl --request GET \
  --url https://api.crun.ai/api/v1/client/job/TaskInfo \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.crun.ai/api/v1/client/job/TaskInfo"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.crun.ai/api/v1/client/job/TaskInfo', 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.crun.ai/api/v1/client/job/TaskInfo",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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.crun.ai/api/v1/client/job/TaskInfo"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	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.crun.ai/api/v1/client/job/TaskInfo")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.crun.ai/api/v1/client/job/TaskInfo")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "running",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": null,
    "credits": 3,
    "duration_s": null,
    "complete_at": null,
    "source": "api"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "success",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": {
      "code": 200,
      "message": "generation success",
      "media_urls": [
        "https://example.com/example.png"
      ],
      "usage": {
        "prompt_tokens": 126,
        "completion_tokens": 32,
        "total_tokens": 158
      }
    },
    "credits": 3,
    "duration_s": 137,
    "complete_at": 1768900515,
    "source": "api"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "failed",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": {
      "code": 501,
      "message": "generation failed"
    },
    "credits": 0,
    "duration_s": 137,
    "complete_at": 1768900515,
    "source": "api"
  }
}

API Endpoint

GET https://api.crun.ai/api/v1/client/job/TaskInfo

This endpoint is used to query the execution status and retrieve the results of tasks created via the /api/v1/client/job/CreateTask API. It provides a unified query interface that is compatible with all models under the Models category, enabling consistent task tracking and result retrieval regardless of the underlying model.

Query Parameters

task_id

string

required

The unique task identifier returned when you created the task.Example: task_12345678

Request Example

curl -X GET "https://api.crun.ai/api/v1/client/job/TaskInfo?task_id=task_12345678" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json"

import requests

API_KEY = "YOUR_API_KEY"

headers = {
  "X-API-KEY": API_KEY,
  "Content-Type": "application/json"
}
params = {
  "task_id": "task_12345678",
}

GET_TASK_STATUS_URL = "https://api.crun.ai/api/v1/client/job/TaskInfo"

response = requests.get(GET_TASK_STATUS_URL, params=params, headers=headers)
print(response.json())

const API_KEY = "YOUR_API_KEY";
const taskId = "task_12345678";

const url = new URL("https://api.crun.ai/api/v1/client/job/TaskInfo");
url.searchParams.append("task_id", taskId);

fetch(url.toString(), {
  method: "GET",
  headers: {
      "X-API-KEY": API_KEY,
      "Content-Type": "application/json",
  },
})
  .then(res => res.json())
  .then(data => {
      console.log(data);
  })
  .catch(err => {
      console.error("Request failed:", err);
  });

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "running",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": null,
    "credits": 3,
    "duration_s": null,
    "complete_at": null,
    "source": "api"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "success",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": {
      "code": 200,
      "message": "generation success",
      "media_urls": [
        "https://example.com/example.png"
      ],
      "usage": {
        "prompt_tokens": 126,
        "completion_tokens": 32,
        "total_tokens": 158
      }
    },
    "credits": 3,
    "duration_s": 137,
    "complete_at": 1768900515,
    "source": "api"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "failed",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": {
      "code": 501,
      "message": "generation failed"
    },
    "credits": 0,
    "duration_s": 137,
    "complete_at": 1768900515,
    "source": "api"
  }
}

Response Format

code

integer

Response status code. 200 indicates the request was successfully processed (the task was found and returned, regardless of execution result).

message

string

Response message. Typically "success".

data

object

The task data object containing all task information.

Show data properties

task_id

string

The unique identifier of the task.

provider

string

The model provider name.Examples: Google, Wan, Bytedance

model_version

string

A specific model version used when creating a task.

status

string

Current status of the task. See Task Status below for details.Possible values: pending, running, success, failed

param

object

Original parameters used to create the task.

Show param properties

model

string

Model identifier used when creating the task.

callback_url

string | null

Webhook callback URL configured for this task.

input

object

Model-specific input parameters. The structure varies depending on the selected model.

result

object | null

Task generation results. valid value is returned only if the task status is success or failed; otherwise, null is returned.

Show result properties

code

integer

Task generation result status code. 200 indicates generation success. Non-200 values indicate generation failure.

message

string

Explanation of task success or failure.

media_urls

array<string>

Task generated media URLs. It will only return if the task status is success.

usage

object

Optional token usage information returned when available. This field is a dictionary and may include values such as prompt_tokens, completion_tokens, and total_tokens.

credits

number

Credits consumed by tasks. When the task status is pending or running, it indicates credits reserved in advance; when the task status is success or failed, it indicates the actual consumed credits.

create_at

integer

Unix timestamp (in seconds) when the task was created.

complete_at

integer | null

Unix timestamp (in milliseconds) when the task was created. null if the task has not finished.

duration_s

integer | null

Task execution duration in seconds. Null if the task has not completed.

source

string

Source of task creation.

Task Status Enum

Status	Description	Action
`pending`	Task is queued and waiting to be processed	Continue polling
`running`	Task is currently being processed	Continue polling
`success`	Task successfully completed	Access result.media_url to get the result
`failed`	Task failed	Access result object to view error code and message.

Get Task Result Best Practices

Recommended Polling Intervals

Polling Interval: Use a polling interval between 15 and 30 seconds
Interval Dynamically: For long-running video generation tasks, consider increasing the polling interval dynamically
Delayed Polling: Wait at least one polling interval before the first status check to reduce unnecessary requests
Maximum polling duration: Stop after 15-20 minutes and investigate

Excessive polling may result in rate limiting. Use callbacks for production applications.

Using Callbacks Instead of Polling

For production applications, we strongly recommend using the callback_url parameter when creating tasks:

No polling needed: Your server receives notifications automatically
Lower API costs: Eliminates continuous polling requests
Better performance: Immediate notifications when tasks complete
Reduced latency: No delay between completion and notification

Recommended method

Handling Completed Tasks

When status is success:

Retrieve the task result from the result field in the response
Extract generated media URLs from result.media_urls
Download media files to your own storage
Persist result metadata to your storage or database

Important: Generated media URLs are typically permanently deleted after 14 days

Common Error Codes

Code	Description	Solution
`401`	Unauthorized - Invalid or missing API key	Check your API key
`404`	Task not found	Verify the task_id is correct
`429`	Exceeding the request rate limit	Reduce request frequency
`500`	Internal server error	Retry after a few minutes
`501`	Generation failed	View the `result` object to get the error code and message.

Rate Limits

Maximum query rate: 15 requests per second, per account limit
Recommended interval: 15-30 seconds between polls

Models Overview

Explore all available models

Get Account Credits

Check your remaining credits

Authorizations

x-api-key

string

header

required

All APIs require authentication via API Key.

Get API Key:

Visit API Key Management Page to get your API Key

Usage: Add to request header:

x-api-key: YOUR_API_KEY

Note:

Keep your API Key secure and do not share it with others
If you suspect your API Key has been compromised, reset it immediately in the management page

Query Parameters

task_id

string

required

Task ID used to retrieve task result.

Required string length: 36

Example:

"task_1234567"

Response

Task information retrieved successfully or task not found.

code

integer

required

Response status code

200: Success - Request has been processed successfully
401: Unauthorized - Authentication credentials are missing or invalid
402: Insufficient Credits - Account does not have enough credits to perform the operation
404: Not Found - The requested resource or endpoint does not exist
422: Validation Error - The request parameters failed validation checks
429: Rate Limited - Request limit has been exceeded for this resource
455: Service Unavailable - System is currently undergoing maintenance
500: Server Error - An unexpected error occurred while processing the request
501: Generation Failed - Content generation task failed
505: Feature Disabled - The requested feature is currently disabled

message

string

required

Response message

data

object

Task record and result information.

Show child attributes

Qwen TTS Voice Design

Introduction

Language Models

Image Models

Video Models

Audio Models

Task

API Endpoint

Query Parameters

Request Example

Response Format

Task Status Enum

Get Task Result Best Practices

Common Error Codes

Rate Limits

Models Overview

Get Account Credits

Authorizations

Query Parameters

Response

​API Endpoint

​Query Parameters

​Request Example

​Response Format

​Task Status Enum

​Get Task Result Best Practices

​Common Error Codes

​Rate Limits

​Related Resources

Models Overview

Get Account Credits

Authorizations

Query Parameters

Response

API Endpoint

Query Parameters

Request Example

Response Format

Task Status Enum

Get Task Result Best Practices

Common Error Codes

Rate Limits

Related Resources