Zum Hauptinhalt springen
GET
/
v1
/
tasks
/
{task_id}
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt?language=en \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "cost": 0.15,
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt?language=en \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "cost": 0.15,
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}

Autorisierungen

Authorization
string
erforderlich
Alle API-Endpunkte erfordern eine Authentifizierung per Bearer TokenSo erhalten Sie Ihren API-Key:Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API-Key zu erhaltenFügen Sie ihn dem Request-Header hinzu:
Authorization: Bearer YOUR_API_KEY

Pfadparameter

task_id
string
erforderlich
Aufgaben-ID, die von der Generierungs-API zurückgegeben wird

Query-Parameter

language
string
Sprache des Antwortinhalts; folgende Werte werden unterstützt:
  • zh – Chinesisch
  • en – Englisch
  • ko – Koreanisch
  • ja – Japanisch
Standard: Englisch

Antwort

id
string
Eindeutige Kennung der Aufgabe
status
string
Mögliche Werte für den Aufgabenstatus:
  • pending – In Warteschlange
  • processing – Wird gerade verarbeitet
  • completed – Erfolgreich abgeschlossen
  • failed – Fehlgeschlagen
  • cancelled – Vom Benutzer abgebrochen
cost
number
Abgerechneter Betrag für diese Aufgabe
progress
integer
Aufgabenfortschritt in Prozent (0–100)
result
object
Aufgabenergebnis; wird nur zurückgegeben, wenn der Status completed ist
created
integer
Zeitstempel der Aufgabenerstellung
completed
integer
Zeitstempel des Aufgabenabschlusses (nur vorhanden, wenn abgeschlossen)
estimated_time
integer
Geschätzte Bearbeitungszeit in Sekunden
actual_time
integer
Tatsächliche Bearbeitungszeit in Sekunden (nur vorhanden, wenn abgeschlossen)
error
object
Fehlerdetails (nur vorhanden, wenn der Status failed ist)