https://github.com/volcengine/volc-sdk-golang
https://github.com/volcengine/volc-sdk-golang
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/volcengine/volc-sdk-golang
- Owner: volcengine
- License: apache-2.0
- Created: 2020-10-25T13:53:01.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2026-01-15T11:53:53.000Z (5 months ago)
- Last Synced: 2026-01-15T16:30:22.759Z (5 months ago)
- Language: Go
- Size: 7.78 MB
- Stars: 144
- Watchers: 1
- Forks: 54
- Open Issues: 2
-
Metadata Files:
- Readme: README.EN.MD
- Changelog: Changelog
- License: LICENSE
Awesome Lists containing this project
README
English | [中文](README.md)
Volcengine SDK for Go
Welcome to Volcengine SDK for Go. This document explains how to obtain and use the SDK.
## Prerequisites
### Enable the service
Make sure the service you want to access is enabled. Go to the [Volcengine Console](https://console.volcengine.com/), select the service from the left navigation (or search it from the top bar), and complete the activation process in the service console.
### Obtain security credentials
Access Key is the credential used to access Volcengine services. It consists of Access Key ID (AK) and Secret Access Key (SK).
Log in to the [Volcengine Console](https://console.volcengine.com/), then go to [IAM](https://console.volcengine.com/iam) -> [Access Keys](https://console.volcengine.com/iam/keymanage/) to create and manage your Access Keys. For more information, see the [Access Key documentation](https://www.volcengine.com/docs/6291/65568).
### Environment check
Go version must be **1.14** or later.
## Install
```go
go get -u github.com/volcengine/volc-sdk-golang
```
## Configuration
### Credential configuration
Volcengine SDK for Go supports the following credential loading methods.
*Note: Replace `Your AK` and `Your SK` in the code with your actual AK and SK.*
**Method 1**: Set AK/SK on the client **(recommended)**
```go
iam.DefaultInstance.Client.SetAccessKey(Your AK)
iam.DefaultInstance.Client.SetSecretKey(Your SK)
```
**Method 2**: Load AK/SK from environment variables
```bash
VOLC_ACCESSKEY="Your AK"
VOLC_SECRETKEY="Your SK"
```
**Method 3**: Load AK/SK from a file under HOME
Add the following content to `~/.volc/config`:
```json
{
"ak": "Your AK",
"sk": "Your SK"
}
```
## Other resources
### Some service directories and examples
- [Visual Intelligence](service/visual/README.md)