Envoyer une instruction textuelle unique à un voyage Acting pour déclencher le jeu de rôle ultérieur et la génération d'images. Appelable lorsque le voyage est en cours d'exécution ou en pause.
Scope
Envoyer une instruction textuelle unique à un voyage Acting pour déclencher le jeu de rôle ultérieur et la génération d'images. Avant d'appeler, confirmez les points suivants :
- Authentification : La clé API principale n'est pas requise ; la clé principale ou une clé API temporaire peut l'appeler. Pour savoir comment les obtenir, voir Obtenir les identifiants d'authentification.
- Prérequis : L'état du voyage doit être
runningoupaused. Confirmez via Query Travel Status. - Appelant : Votre serveur ou votre client peut l'appeler.
Requête HTTP
- Singapore
- États-Unis (Virginie)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/instructRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.Paramètres de la requête |
|
Content-Typestring(Requis)Type de contenu de la requête. Ce paramètre doit être défini sur application/json. | |
Authorization string (Requis)Authentification par clé API. La clé API principale n'est pas requise ; la clé principale ou une clé API temporaire peut l'appeler.
| |
Corps de la requête | |
encryptedTravelId string (Obligatoire)L'identifiant de voyage Acting chiffré à contrôler. Retourné par Enter Travel. | |
content string (Obligatoire)L'instruction de processus textuelle. Non vide, jusqu'à 2000 caractères ; retourne 400000 si elle est manquante, vide ou dépasse la limite. | |
clientRequestId string (Facultatif)Clé d'idempotence pour les nouvelles tentatives d'instructions. Réutilisez la même valeur lors d'une nouvelle tentative pour la même instruction afin d'éviter une facturation en double. Format recommandé [A-Za-z0-9_-]{1,32}.
| |
userAgent string (Facultatif)Identifiant de version du SDK ou du client. Une chaîne non vide ; prévaut sur le User-Agent HTTP. |
Paramètres de réponse |
|
code integerCode de retour. 0 indique un succès ; une valeur non nulle correspond à un code d'erreur. | |
message stringMessage d'erreur. null en cas de succès. | |
data objectDonnées de réponse. null en cas d'échec.
Propriétés encryptedTravelId stringL'identifiant de voyage chiffré.content stringLe texte d'instruction accepté.accepted booleanIndique si l'instruction a été acceptée et est entrée dans le flux de traitement. |
États préalables et notes d'appel
- L'état du voyage doit être
runningoupaused. contentest obligatoire et ne peut pas être vide ni contenir uniquement des espaces blancs, jusqu'à 2000 caractères.- L'envoi d'une instruction dans l'état
pausedaccepte uniquement l'instruction et ne reprend pas automatiquement le voyage ; lorsque vous devez continuer l'exécution, le client doit appeler séparément Resume Travel. - Réutilisez le
clientRequestIdlors d'une nouvelle tentative pour la même instruction logique afin d'éviter une facturation en double. - Un voyage terminé ou ayant échoué n'est pas modifiable.
- Lorsque l'instruction ne respecte pas la politique de sécurité du contenu,
403004est retourné. - Le
creationModeld'Acting est toujourssimple, il n'est donc pas nécessaire de prendre en compte le sous-mode ScriptList.
Codes d'erreur
Si l'appel du modèle échoue et renvoie une erreur, consultez Codes d'erreur HappyOyster pour la résoudre.
Étapes suivantes
Après l'envoi de l'instruction :
- Query Travel Status : consulter l'état d'exécution des instructions et les informations sur les chapitres.
- Pause Travel / Resume Travel : contrôler le rythme d'exécution.
- End Travel : terminer la session et traiter les artefacts.