Skip to main content
Grok Tasks API:s huvudsakliga funktion är att genom att ange uppgifts-ID:t som genererats av Grok Videos Generation API, kontrollera statusen för den uppgiften. Detta dokument kommer att ge en detaljerad beskrivning av integrationen av Grok Tasks API, vilket hjälper dig att enkelt integrera och kontrollera statusen för uppgifter från Grok Videos Generation API.

​
Ansökningsprocess

För att använda Grok Videos Generation API, börja med att gå till Ace Data Cloud-konsolen för att hämta din API-token, som du ska spara. Om du inte redan är inloggad eller registrerad, kommer du automatiskt att omdirigeras till inloggningssidan där du blir inbjuden att registrera dig och logga in, och efter att ha 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, det behövs ingen separat ansökan för varje tjänst. Vid första ansökan får du en gratis kvot för att prova; om kvoten tar slut kan du ladda på allmän saldo i konsolen.
📘 Fullständig dokumentation: Grok Videos Generation API →

​
Begärningsexempel

Grok Tasks API kan användas för att kontrollera resultaten från Grok 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: uppgifts-ID:t som ska kontrolleras.
  • action: hur uppgiften ska hanteras, för enskild kontroll anges retrieve.

​
CURL kodexempel

​
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 uppdraget, och response-fältet är svaret som returneras efter att uppgiften har slutförts, till exempel:
Fälten beskrivs nedan:
  • id: ID:t för den genererade uppgiften, som används för att unikt identifiera denna genererade uppgift.
  • request: begärningsinformationen i uppgiften.
  • response: svarsinformationen i 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: tiden 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 detaljerna för flera uppgifts-ID:n, ställ in action till retrieve_batch, och skicka in uppgifts-ID-arrayen via ids: Begärningskropp inkluderar:
  • ids: array av uppgifts-ID:n som ska kontrolleras.
  • action: hur uppgiften ska hanteras, för batchfrågor anges retrieve_batch.