Gonka API: conecta y prueba los modelos
Inferencia para agentes, programación y tareas en segundo plano. Puedes acceder a los modelos de la red mediante un bróker, OpenBroker o tu propio gateway.
Obtén una clave y conecta la API.
- 01
Elige un bróker
Regístrate en su web y crea una clave de API.
- 02
Configura tu herramienta
Introduce la Base URL, la clave del bróker y el Model ID exacto.
- 03
Envía tu primera solicitud
Ejecuta un agente, una automatización o una consulta al modelo.
Gonka API
Gonka DAHL
Hyperfusion
Gonka Router
Qué puedes hacer con Gonka
Agentes, programación y tareas de texto: casos de uso, capacidades y límites de la red.
En las herramientas que ya utilizas
Una API para tus tareas
Prueba un modelo aquí sin registrarte ni obtener una clave. Para tus scripts, agentes y tareas en segundo plano, conecta la API del bróker que elijas.
Ejemplo de primera solicitud · Python
import json, os
from urllib.request import Request, urlopen
request = Request(
os.environ["GONKA_BASE_URL"] + "/chat/completions",
headers={
"Authorization": "Bearer " + os.environ["GONKA_API_KEY"],
"Content-Type": "application/json",
},
data=json.dumps({
"model": os.environ["GONKA_MODEL"],
"messages": [{"role": "user", "content": "Hello, Gonka!"}],
}).encode(),
)
with urlopen(request) as response:
print(json.load(response)["choices"][0]["message"]["content"])OpenBroker: precios de la red en GNK
Si tienes GNK y quieres conectar aplicaciones o emitir claves para usuarios, OpenBroker se encarga del gateway y de las sesiones devshard.
- 01
Crea una cuenta
Indica tu organización, correo electrónico y dirección de la cartera de Gonka.
- 02
Deposita GNK
Envía GNK nativo a la dirección de depósito. La guía actual exige al menos 100 GNK para activar la cuenta; consulta la documentación por si ha cambiado.
- 03
Emite una clave
Tras la activación, crea una clave obk- en el panel.
- 04
Conecta tu aplicación
Configura el endpoint, la clave y el modelo. No necesitas desplegar un gateway.
OpenBroker indica un recargo del 0%: pagas la ejecución en la red, incluidos los reintentos. El coste total sigue dependiendo del número de tokens y de cómo se ejecute la solicitud.
OpenBroker opera la cartera autorizada, los escrows y el gateway. Tú creas las claves de tus aplicaciones.
Tu propio gateway y las sesiones devshard
Para operadores que necesitan controlar las claves de escrow, gestionar sesiones y liquidar directamente con la red. Tú operas la infraestructura.
- 01
Acceso mediante gobernanza
La dirección que crea el escrow debe estar en la lista de permitidos de la cadena. Los hosts modifican esa lista mediante votación. Presentar una solicitud no concede acceso.
- 02
Tu servidor y tus claves
Ejecuta el gateway en tu equipo, configura el acceso y añade fondos a una cartera de GNK dedicada.
- 03
Gestiona las sesiones devshard
Abre sesiones, dirige las solicitudes, gestiona la rotación y liquida los pagos con la red.
Un devshard es una sesión de inferencia respaldada por un depósito en la red y un registro de las solicitudes. El gateway gestiona su ciclo de vida. No es un modelo ni un nodo GPU.
¿Por qué está restringido el acceso?
El acceso directo a devshards afecta al funcionamiento de la red y a la contabilidad de las solicitudes. Mientras se desarrollan las protecciones, la seguridad y la estabilidad también dependen de un grupo limitado de operadores. La reputación, las contribuciones y un caso de uso concreto ayudan a evaluar la solicitud; la decisión final se toma mediante gobernanza.
Se prevé avanzar hacia el acceso sin autorización previa. La documentación actual no fija una fecha para retirar la lista de permitidos; 2027 no debe interpretarse como un plazo garantizado.
Antes de la primera solicitud
¿Necesito GNK para empezar?
Con un bróker convencional, no necesariamente: los medios de pago y las bonificaciones dependen del servicio. OpenBroker y un gateway propio utilizan GNK nativo.
¿Qué modelos están disponibles?
El catálogo cambia. Copia el Model ID exacto de tu proveedor; aparecer en la lista no garantiza que haya capacidad disponible en ese momento.
¿Necesito una clave para la demostración?
No. GNK Space paga la demostración. Si se alcanza un límite o el modelo no está disponible, inténtalo más tarde. Para tu IDE o aplicación, obtén tu propia clave de un bróker.
¿La API sirve solo para chatear?
También puedes utilizarla con agentes, procesamiento de texto y tareas en segundo plano. Comprueba qué funciones admiten el bróker y el modelo, incluida la llamada a herramientas.