API Specification of the Relay

The OpenAPI specification of the Relay

Resources

The JSON schema of the OpenAPI Specification of the Relay can be found at:

https://dy.relay.crynux.ai/openapi.jsondy.relay.crynux.ai

The rendered document of the specification can be accessed at:

https://dy.relay.crynux.ai/static/api_docs.html

API List

Task Related APIs

Create an inference task

POST/v1/inference_tasks

Body

application/json

signature*string

Signature

task_args*string

Task arguments

task_id*integer (int64)

Task id

timestamp*integer (int64)

Signature timestamp

Response

200400500

OK

Body

application/json

dataInferenceTask (object)

messagestring

The response message. Will be 'success' or a detailed error type

Request

JavaScriptCurlPython

const response = await fetch('/v1/inference_tasks', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "signature": "text",
      "task_args": "text"
    }),
});
const data = await response.json();

Response

200400500

{
  "data": {
    "CreatedAt": "2024-10-22T08:42:48.090Z",
    "DeletedAt": {
      "Time": "2024-10-22T08:42:48.090Z",
      "Valid": false
    },
    "SelectedNodes": [
      {
        "CreatedAt": "2024-10-22T08:42:48.090Z",
        "DeletedAt": {
          "Time": "2024-10-22T08:42:48.090Z",
          "Valid": false
        },
        "IsResultSelected": false,
        "NodeAddress": "text",
        "Result": "text",
        "UpdatedAt": "2024-10-22T08:42:48.090Z"
      }
    ],
    "UpdatedAt": "2024-10-22T08:42:48.090Z",
    "abort_reason": "text",
    "creator": "text",
    "data_hash": "text",
    "task_args": "text",
    "task_fee": 0,
    "task_hash": "text"
  },
  "message": "text"
}

Get an inference task by task id

GET/v1/inference_tasks/{task_id}

Path parameters

task_id*integer (int64)

The task id

Query parameters

Response

200400

OK

Body

application/json

dataInferenceTask (object)

messagestring

The response message. Will be 'success' or a detailed error type

Request

JavaScriptCurlPython

const response = await fetch('/v1/inference_tasks/{task_id}?signature=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "data": {
    "CreatedAt": "2024-10-22T08:42:48.090Z",
    "DeletedAt": {
      "Time": "2024-10-22T08:42:48.090Z",
      "Valid": false
    },
    "SelectedNodes": [
      {
        "CreatedAt": "2024-10-22T08:42:48.090Z",
        "DeletedAt": {
          "Time": "2024-10-22T08:42:48.090Z",
          "Valid": false
        },
        "IsResultSelected": false,
        "NodeAddress": "text",
        "Result": "text",
        "UpdatedAt": "2024-10-22T08:42:48.090Z"
      }
    ],
    "UpdatedAt": "2024-10-22T08:42:48.090Z",
    "abort_reason": "text",
    "creator": "text",
    "data_hash": "text",
    "task_args": "text",
    "task_fee": 0,
    "task_hash": "text"
  },
  "message": "text"
}

Upload inference task result

POST/v1/inference_tasks/{task_id}/results

Path parameters

task_id*integer (int64)

Task id

Body

application/json

signature*string

Signature

timestamp*integer (int64)

Signature timestamp

Response

200400500

OK

Body

application/json

messagestring

The response message. Will be 'success' or a detailed error type

Request

JavaScriptCurlPython

const response = await fetch('/v1/inference_tasks/{task_id}/results', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "signature": "text"
    }),
});
const data = await response.json();

Response

200400500

{
  "message": "text"
}

Get the result of the inference task by node address

GET/v1/inference_tasks/{task_id}/results/{image_num}

Path parameters

image_num*string

Image number

task_id*integer (int64)

Task id

Query parameters

Response

200400

OK

Request

JavaScriptCurlPython

const response = await fetch('/v1/inference_tasks/{task_id}/results/{image_num}?signature=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

400

{
  "data": {
    "field_name": "text",
    "message": "text"
  },
  "message": "text"
}

Network Stats Related APIs

Get total TFLOPS of the network

GET/v1/network

Response

200400

OK

Body

application/json

dataNetworkTFLOPS (object)

messagestring

The response message. Will be 'success' or a detailed error type

Request

JavaScriptCurlPython

const response = await fetch('/v1/network', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "data": {
    "tflops": 0
  },
  "message": "text"
}

Get the info of all the nodes in the network

GET/v1/network/nodes/data

Query parameters

Response

200400

OK

Body

application/json

dataarray of NetworkNodeData (object)

messagestring

The response message. Will be 'success' or a detailed error type

Request

JavaScriptCurlPython

const response = await fetch('/v1/network/nodes/data', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "data": [
    {
      "CreatedAt": "2024-10-22T08:42:48.090Z",
      "DeletedAt": {
        "Time": "2024-10-22T08:42:48.090Z",
        "Valid": false
      },
      "UpdatedAt": "2024-10-22T08:42:48.090Z",
      "address": "text",
      "card_model": "text"
    }
  ],
  "message": "text"
}

Get total nodes number in the network

GET/v1/network/nodes/number

Response

200400

OK

Body

application/json

dataAllNodeNumber (object)

messagestring

The response message. Will be 'success' or a detailed error type

Request

JavaScriptCurlPython

const response = await fetch('/v1/network/nodes/number', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "data": {},
  "message": "text"
}

Get total task number in the network

GET/v1/network/tasks/number

Response

200400

OK

Body

application/json

dataAllTaskNumber (object)

messagestring

The response message. Will be 'success' or a detailed error type

Request

JavaScriptCurlPython

const response = await fetch('/v1/network/tasks/number', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "data": {},
  "message": "text"
}

Other APIs

Get current unix timestamp of server

GET/v1/now

Response

200400

OK

Body

application/json

dataNowTimestamp (object)

messagestring

The response message. Will be 'success' or a detailed error type

Request

JavaScriptCurlPython

const response = await fetch('/v1/now', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "data": {},
  "message": "text"
}