Configure para usar a IBM Quantum Platform com a API REST

Você pode acessar processadores quânticos com APIs REST, o que lhe permite trabalhar com QPUs usando qualquer linguagem ou estrutura de programação.

1. Obtenha acesso

1. Se você ainda não possui uma conta de usuário, crie uma na página de login IBM Quantum.
2. Crie uma chave API (também chamada de token) no painel. Observe que a mesma chave API pode ser usada para qualquer uma das regiões.
3. Gerar um token de portador IBM Cloud Identity and Access Management (IAM). Esse é um token de curta duração usado para autenticar solicitações à API REST. Para gerar um, chame a API do IAM Identity Services, conforme mostrado na solicitação de amostra a seguir:

curl -X POST 'https://iam.cloud.ibm.com/identity/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey=MY_APIKEY'

{
   "access_token": "eyJhbGciOiJIUz......sgrKIi8hdFs",
   "refresh_token": "SPrXw5tBE3......KBQ+luWQVY=",
   "token_type": "Bearer",
   "expires_in": 3600,
   "expiration": 1473188353
}

# Use 'service' to invoke operations.
import requests
import json

url = 'https://iam.cloud.ibm.com/identity/token'
api_key = 'MY_APIKEY'
headers = {
 'Content-Type': 'application/x-www-form-urlendcoded',
}
data = f'grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey={api_key}'
response = requests.post(url, headers=headers, data=data)

# Bearer token to authorize requests to the REST API
bearer_token = response.json()['access_token']

2. Escolha um método de autenticação

Escolha o método de autenticação apropriado, dependendo de seu ambiente de trabalho:

• Crie uma variável de ambiente para sua chave de API (ambientes confiáveis Python )
• Use sua chave de API diretamente (ambiente não confiável)

Crie uma variável de ambiente (ambiente confiável)

1. Para definir a variável de ambiente IQP_API_TOKEN em seu sistema, você pode adicionar a seguinte linha ao seu perfil de shell (por exemplo,.bashrc ou.zshrc) ou defini-la diretamente no terminal:

   export IQP_API_TOKEN=<your-API_KEY> 
   # Use the 44-character API_KEY you created and saved 
   # from the IBM Quantum Platform Home dashboard

   Ao invocar a variável de ambiente em seu código, inclua import os, como neste exemplo:

   import os
   api_token = os.environ['IQP_API_TOKEN']

   Observe que, ao criar uma variável de ambiente, sua chave de API ainda é armazenada localmente em texto simples e deve ser protegida.

2. Autentique as solicitações à API REST do site Qiskit Runtime incluindo o CRN e o token do portador nos cabeçalhos da solicitação.

curl -X 'GET' \
   'https://quantum.cloud.ibm.com/api/v1/usage' \
   '-H accept: application/json' \
   '-H authorization: Bearer <BEARER_TOKEN>' \
   '-H Service-CRN: <INSTANCE_CRN>'

3. Opcional: Configure seu firewall

Se necessário, use essas informações para habilitar o acesso aos endpoints da API do IBM Quantum.

Próximas etapas