> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini Tasks API:s integration och användning

> Gemini AI API guide - Ace Data Cloud

Gemini Tasks API:s huvudsakliga funktion är att genom att ange uppgiftens ID som genererats av Gemini Videos Generation API, kunna kontrollera statusen för den uppgiften.

Detta dokument kommer att ge en detaljerad beskrivning av Gemini Tasks API:s integrationsanvisningar, för att hjälpa dig att enkelt integrera och kontrollera statusen för uppgifter från Gemini Videos Generation API.

## Ansökningsprocess

För att använda Gemini Videos Generation API, börja med att gå till [Ace Data Cloud-konsolen](https://platform.acedata.cloud/console/applications) för att hämta din API-token, som du ska spara.

![](https://cdn.acedata.cloud/dvc3cg.jpg)

Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan där du blir inbjuden att registrera dig och logga in, och efter att du har slutfört detta kommer du automatiskt att återvända till den aktuella sidan.

**En API-token räcker för att anropa alla tjänster på plattformen, du behöver inte ansöka separat för varje tjänst.** Första ansökan ger en gratis kvot, så att du kan prova gratis; när kvoten är slut kan du ladda på allmän saldo i [konsolen](https://platform.acedata.cloud/console/coin).

> 📘 Fullständig dokumentation: [Gemini Videos Generation API →](https://platform.acedata.cloud/documents/gemini-videos)

## Begärningsexempel

Gemini Tasks API kan användas för att kontrollera resultaten från Gemini Videos Generation API.

### Ställ in begärningshuvuden och begärningskropp

**Begärningshuvuden** inkluderar:

* `accept`: anger att du vill ta emot svar i JSON-format, här anges `application/json`.
* `authorization`: nyckeln för att anropa API:t, som kan väljas direkt efter ansökan.

**Begärningskropp** inkluderar:

* `id`: ID för den uppgift som ska kontrolleras.
* `action`: åtgärden för uppgiften, för enskild kontroll anges `retrieve`.

### CURL kodexempel

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/gemini/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "action": "retrieve"
}'
```

### Svarsexempel

Vid en lyckad begäran kommer API:t att returnera detaljerad information om uppgiften här. Där `request`-fältet är begärningskroppen vid uppgiftsstart och `response`-fältet är svaret som returneras efter att uppgiften har slutförts, till exempel:

```json theme={null}
{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "started_at": 1769262721.823,
  "finished_at": 1769262730.723,
  "elapsed": 8.9,
  "request": {
    "prompt": "En filmisk bild av en kattunge som jagar en fjäril i en solbelyst trädgård",
    "model": "omni-flash",
    "aspect_ratio": "16:9"
  },
  "type": "videos",
  "response": {
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
      {
        "id": "omni-flash:job_01k777hjrbfrgs2060q5zvf2a5",
        "video_url": "https://cdn.acedata.cloud/gemini/example-video.mp4",
        "state": "succeeded"
      }
    ]
  }
}
```

Fälten beskrivs nedan:

* `id`: ID för den genererade uppgiften, används för att unikt identifiera denna genererade uppgift.
* `request`: begärningsinformation för den kontrollerade uppgiften.
* `response`: returinformation för den kontrollerade uppgiften.
* `created_at`: tidpunkten då uppgiften skapades, Unix-tidsstämpel (sekunder, flyttal).
* `started_at`: tidpunkten då uppgiften började utföras, Unix-tidsstämpel (sekunder, flyttal).
* `finished_at`: tidpunkten då uppgiften slutfördes, Unix-tidsstämpel (sekunder, flyttal). Detta fält returneras inte om uppgiften inte är slutförd.
* `elapsed`: tid som uppgiften tog att utföra, i sekunder (flyttal, med 3 decimaler). Detta fält returneras inte om uppgiften inte är slutförd.

## Batchfrågeoperationer

För att kontrollera detaljer för flera uppgift-ID:n, ställ in `action` till `retrieve_batch` och skicka in en array av uppgift-ID:n via `ids`:

**Begärningskropp** inkluderar:

* `ids`: array av uppgift-ID:n som ska kontrolleras.
* `action`: åtgärden för uppgiften, för batchkontroll anges `retrieve_batch`.

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/gemini/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["b8976e18-32dc-4718-9ed8-1ea090fcb6ea"],
  "action": "retrieve_batch"
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.