Récupérer une clé API

GET

api

token

{id}

cURL

curl https://api.cometapi.com/api/token/1234 \
  -H "Authorization: your-access-token"

import requests

url = "https://api.cometapi.com/api/token/{id}"

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

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

print(response.text)

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

fetch('https://api.cometapi.com/api/token/{id}', 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.cometapi.com/api/token/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <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.cometapi.com/api/token/{id}"

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

	req.Header.Add("Authorization", "<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.cometapi.com/api/token/{id}")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/api/token/{id}")

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

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

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

{
  "success": true,
  "message": "",
  "data": {
    "id": 1234,
    "user_id": 5678,
    "key": "$COMETAPI_KEY",
    "status": 1,
    "name": "production",
    "created_time": 1766102400,
    "accessed_time": 1766102400,
    "expired_time": -1,
    "remain_quota": 100000,
    "unlimited_quota": false,
    "model_limits_enabled": false,
    "model_limits": "",
    "allow_ips": null,
    "used_quota": 0,
    "group": "",
    "cross_group_retry": false
  }
}

Utilisez ce endpoint pour récupérer un enregistrement de clé API par ID.

Générez un personal access token dans Console → Personal Settings, puis envoyez-le comme valeur brute de l’en-tête Authorization. Ne le préfixez pas avec Bearer.

Le paramètre de chemin id est l’ID numérique de la clé renvoyé par Lister les clés API.

Statut de la clé API

Status	Meaning
`1`	Activée
`2`	Désactivée
`3`	Expirée
`4`	Épuisée

Champs renvoyés

Field	Type	Description
`id`	integer	ID numérique de la clé API. Utilisez cette valeur avec Mettre à jour une clé API et Supprimer une clé API.
`key`	string	Valeur de la clé API renvoyée par l’API de gestion. Traitez-la comme un secret et utilisez-la comme `Authorization: Bearer $COMETAPI_KEY` pour les requêtes de modèle.
`status`	integer	Statut opérationnel. Seule la valeur `1` signifie que la clé est activée pour les requêtes de modèle.
`name`	string	Nom d’affichage lisible par l’utilisateur pour la clé.
`created_time`	integer	Horodatage Unix en secondes indiquant quand la clé a été créée.
`accessed_time`	integer	Horodatage Unix en secondes indiquant quand la clé a été utilisée pour la dernière fois.
`expired_time`	integer	Horodatage Unix en secondes indiquant quand la clé expire. `-1` signifie aucune expiration.
`remain_quota`	integer	Quota restant en unités de quota internes de CometAPI.
`used_quota`	integer	Quota déjà consommé par cette clé en unités de quota internes de CometAPI.
`unlimited_quota`	boolean	Indique si la clé contourne les vérifications de quota restant.
`model_limits_enabled`	boolean	Indique si les restrictions de modèle sont actives pour cette clé.
`model_limits`	string	model ID autorisés par cette clé, séparés par des virgules, lorsque `model_limits_enabled` vaut `true`. Une valeur vide signifie qu’aucune liste de modèles n’est configurée.
`allow_ips`	string or null	Liste d’autorisation IP sous la forme d’une chaîne unique séparée par des sauts de ligne. Chaque entrée peut être une adresse IPv4 unique, une adresse IPv6 unique, un CIDR IPv4 ou un CIDR IPv6. `null` ou `""` signifie aucune restriction IP.
`group`	string	Restriction de groupe de compte. Une valeur vide signifie aucune restriction de groupe explicite.
`cross_group_retry`	boolean	Indique si la nouvelle tentative inter-groupe est activée pour le routage automatique des groupes.

Autorisations

Authorization

string

header

requis

Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.

Paramètres de chemin

integer

requis

Numeric API key ID returned by the list endpoint.

Réponse

200 - application/json

API key record.

success

boolean

requis

message

string

requis

data

object

requis

Show child attributes

Créer une clé API

Supprimer une clé API

cURL

curl https://api.cometapi.com/api/token/1234 \
  -H "Authorization: your-access-token"

import requests

url = "https://api.cometapi.com/api/token/{id}"

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

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

print(response.text)

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

fetch('https://api.cometapi.com/api/token/{id}', 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.cometapi.com/api/token/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <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.cometapi.com/api/token/{id}"

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

	req.Header.Add("Authorization", "<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.cometapi.com/api/token/{id}")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/api/token/{id}")

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

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

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

{
  "success": true,
  "message": "",
  "data": {
    "id": 1234,
    "user_id": 5678,
    "key": "$COMETAPI_KEY",
    "status": 1,
    "name": "production",
    "created_time": 1766102400,
    "accessed_time": 1766102400,
    "expired_time": -1,
    "remain_quota": 100000,
    "unlimited_quota": false,
    "model_limits_enabled": false,
    "model_limits": "",
    "allow_ips": null,
    "used_quota": 0,
    "group": "",
    "cross_group_retry": false
  }
}

Modération de contenu

Clés API

Statut de la clé API

Champs renvoyés

Autorisations

Paramètres de chemin

Réponse

​Statut de la clé API

​Champs renvoyés

Autorisations

Paramètres de chemin

Réponse

Statut de la clé API

Champs renvoyés